Crypto media sentiment, as an API.
Sentiment data from the news HafidWatch processes, for developers. 16 endpoints, JSON or CSV, including our Divergence Index. Updated every hour.
7-day free trial · No credit card required · Not financial advice
The Divergence Index. Two groups of media, one gap.
/v1/divergence/current returns the gap between the tone of the mainstream financial outlets and the crypto-native outlets that HafidWatch monitors, over the last 24 hours. It describes coverage. It does not predict prices.
- Mainstream vs crypto-native sentiment, measured separately
- Gap expressed in percentage points
- Updated every hour, as new articles are processed
- Weekly historical series for your own analysis
- Based on a small set of sources, so short windows hold few articles. Full methodology →
← Swipe the block to see the full response →
Choose your plan.
All plans include the Divergence Index endpoint, full JSON responses, and commercial use rights.
Developer
- All 16 endpoints
- /v1/divergence/current
- 7 days of historical data
- CSV or JSON export
- Hourly data updates
- Commercial use
- Email support
Starter
- All 16 endpoints
- /v1/divergence/current
- 30 days of historical data
- CSV or JSON export
- Hourly data updates
- Commercial use
- Email support
Pro
- All 16 endpoints
- /v1/divergence/current
- 90 days of historical data
- CSV or JSON export
- Hourly data updates
- Webhook notifications
- Commercial use
- Email support
Enterprise
- All 16 endpoints
- /v1/divergence/current
- 365 days of historical data
- CSV or JSON export
- Hourly data updates
- Webhook notifications
- Commercial use
- Email support
16 endpoints. JSON or CSV.
Every endpoint returns JSON and is documented at api.hafidwatch.com. Authentication via X-HafidWatch-Key header. Add ?format=csv to any list-based endpoint to download it as a CSV file instead of JSON.
/v1/divergence/current unique
Gap between mainstream and crypto-native media sentiment over the last 24h.
/v1/divergence/history
Weekly divergence gap series with configurable date range.
/v1/sentiment/current
24h market sentiment breakdown alongside the latest HafidWatch Score.
/v1/sentiment/history
Sentiment time series — daily or weekly granularity, filterable by ticker.
/v1/sentiment/by-category
Sentiment breakdown by narrative category — Markets, DeFi, Macro, Regulation, AI.
/v1/tickers/trending
Top tickers by media mentions with sentiment breakdown. Configurable period.
/v1/tickers/{ticker}/sentiment
Historical daily sentiment for a specific ticker — bullish/bearish trend over time.
/v1/tickers/{ticker}/articles
Most recent articles mentioning a ticker, with the AI-assigned sentiment and score.
/v1/signals/latest
Latest alerts from the Premium Alerts engine, filterable by alert type.
/v1/signals/history
Alert history with counts by alert type over a configurable window.
/v1/market/snapshot
All market data in one call: HafidWatch Score, sentiment, BTC price, F&G, funding rate.
/v1/market/sources/leaderboard
Sources ranked by average article score, with sentiment breakdown. Configurable window (24h/7d/30d).
/v1/status no key required
Real, measured uptime over 24h/7d/30d — checked every 5 minutes by our monitoring system. Not a promised SLA, a public number anyone can query.
/v1/webhooks Pro/Enterprise
Register a webhook. Get notified when an alert fires, a new weekly HafidWatch Score is published, or the API’s status changes, instead of polling.
/v1/webhooks Pro/Enterprise
List your own webhook subscriptions. Secrets are shown once, at creation, and never again.
/v1/webhooks/{id} Pro/Enterprise
Remove a webhook subscription. Only the key that created it can delete it.
Built for people who work with market data.
Quant traders
Testing whether media sentiment adds anything to their own models.
Algo developers
Pulling sentiment data into their own systems through webhooks or polling.
Fintech products
Embedding market mood data into dashboards, mobile apps, or analytics platforms.
Researchers
Studying the relationship between media coverage and price using the historical endpoints.
Common questions.
Is there a free trial?
Yes. Write to us through our contact form, mention “API trial”, and we will send you a 7-day trial key with Developer-level access. No credit card required.
How is the Divergence Index calculated?
We split the sources HafidWatch monitors into two groups: mainstream financial media (currently CNBC) and crypto-native media (such as Cointelegraph, Decrypt, CryptoSlate and Protos). AI models from OpenAI label each article as bullish, bearish, neutral or mixed. The Divergence Index is the gap, in percentage points, between the share of bullish articles in each group. It updates every hour as new articles are processed. Articles are not weighted by outlet or by recency.
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?
There is no formal SLA today. GET /v1/status (no API key required) returns the measured uptime over the last 24h/7d/30d, checked every 5 minutes. Anyone can query it and see the same number we do.
How do webhooks work?
Available on Pro and Enterprise plans. Register a URL via POST /v1/webhooks along with the events you care about — signal (a Premium Alert fires), weekly_score (a new HafidWatch Score is published), or api_status (the API’s up/down state changes). Every delivery is signed with a per-subscription secret via the X-HafidWatch-Signature header (HMAC-SHA256), so you can verify that it came from HafidWatch before you trust the payload.
Can I use the data commercially?
Yes. All plans include commercial use rights, under our Terms & Conditions. White-label use is available only on the Enterprise plan. Do not share your API key.
How much data is behind the numbers?
HafidWatch monitors seven news sources and processes roughly 70 articles a week. A 24-hour window can hold only a handful of articles, and the mainstream group is the smaller of the two, so short-window figures can swing on one or two stories. The history limits in each plan are maximums: the data goes back only as far as HafidWatch has collected it.
Is the data a trading signal?
No. The API returns measurements of media coverage, labeled by AI models that can be wrong. It does not predict prices and it is not financial advice. If you use it in a trading system, you do so at your own risk. See our Financial Disclaimer.
When does the API launch?
Public launch is planned for October 28, 2026. You can request early access now through our contact form. Trial keys are available before the launch date.
Start with a 7-day free trial.
Write to us and we will send your trial key by email.
- All 16 endpoints, including /v1/divergence/current
- Developer-level access (200 req/day)
- Full API documentation
- 7 days free — no credit card
- Upgrade to any paid plan anytime
One person runs HafidWatch. We reply within 48 hours. No credit card required.
View API docs