/v1/divergence/current returns the real-time gap between what mainstream financial media (Bloomberg, Reuters, FT, WSJ) and crypto-native outlets (CoinDesk, The Block, HackerNews, Bluesky) are saying about the same market. That gap historically precedes price movements.
→ Mainstream vs crypto-native sentiment, measured separately
→ Gap expressed in percentage points — clear, actionable
→ Updated in real-time from 50+ classified sources
Every endpoint returns clean JSON, documented at api.hafidwatch.com. Authentication via X-HafidWatch-Key header.
GET
/v1/divergence/current ★ unique
Real-time gap between mainstream and crypto-native media sentiment. The flagship signal.
GET
/v1/divergence/history
Historical divergence data with configurable date range. Available on Starter+.
GET
/v1/sentiment/current
Overall market sentiment score and breakdown across all monitored sources.
GET
/v1/sentiment/history
Sentiment time series — hourly, daily, or weekly granularity.
GET
/v1/tickers/trending
Top tickers by media mentions and sentiment signal strength in the last 24h.
GET
/v1/tickers/{ticker}/sentiment
Sentiment breakdown for a specific ticker — score, direction, source count.
GET
/v1/signals/high-conviction
Articles and events currently scoring above 0.8 signal strength threshold.
GET
/v1/market/pulse
Composite market mood snapshot — sentiment, Fear & Greed, funding rate in one call.
GET
/v1/sources/leaderboard
Weekly ranking of news sources by average signal quality and article volume.
GET
/v1/narratives/trending
Rising and falling narratives by category — Markets, DeFi, Macro, Regulation.
GET
/v1/articles/recent
Latest processed articles with full AI metadata — sentiment, score, tickers, summary.
POST
/v1/webhooks
Register a webhook URL to receive real-time event pushes. Available on Pro+.
Who it’s for
Built for people who trade on information advantage.
📐
Quant traders
Building sentiment-aware strategies that react to narrative momentum before it shows in price.
🤖
Algo developers
Integrating real-time sentiment signals into automated trading systems via webhooks or polling.
🏦
Fintech products
Embedding market mood data into dashboards, mobile apps, or analytics platforms.
🔬
Researchers
Backtesting the correlation between divergence signals and price movements using historical exports.
FAQ
Common questions.
Is there a free trial?
Yes. Email our contact form mentioning “API trial” and we’ll send you a 7-day trial key with Developer-level access. No credit card required.
How is the Divergence Index calculated?
We classify 50+ sources into two tiers: mainstream financial media (Bloomberg, Reuters, FT, WSJ, AP) and crypto-native media (CoinDesk, The Block, HackerNews, Bluesky). Each article is analyzed by GPT-4 for sentiment and signal strength. The gap between the two groups’ weighted sentiment scores — expressed in percentage points — is the Divergence Index. It updates in real time as new articles are processed.
How do I authenticate API requests?
All requests require a X-HafidWatch-Key header with your API key. Keys are generated after subscription and sent to your email. Full documentation is available at api.hafidwatch.com/docs.
What’s the uptime SLA?
Pro and Enterprise plans include a 99.5% uptime SLA. Developer and Starter plans operate on a best-effort basis — in practice the API runs 24/7 on the same infrastructure as our main publishing pipeline.
Can I use the data commercially?
Yes. All plans include commercial use rights. If you need a white-label arrangement — embedding the data under your own brand — that’s available on the Enterprise plan.
When does the API launch?
Public launch is October 28, 2026. You can request early access now via our contact form — trial keys are available before the official launch date.
Start with a 7-day free trial.
Email us and we’ll send your trial key within a few hours.
HAFIDWATCH SENTIMENT API · TRIAL ACCESS
All 12 endpoints, including /v1/divergence/current