SENTIMENT API · REAL-TIME DATA
The signal before the market moves.
Real-time crypto sentiment intelligence for developers and quants. 16 endpoints. The only Divergence Index on the market.
from
$49
/month
Request trial access →
7-day free trial · No credit card required
16Endpoints
50+Sources monitored
24/7Real-time
4Plans
★ Unique in the market
Flagship endpoint
The Divergence Index. Nothing else like it.
/v1/divergence/current returns the real-time gap between what mainstream financial media (Bloomberg, Reuters, FT, WSJ) and crypto-native outlets (CoinDesk, The Block, Decrypt) 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
- → Daily historical divergence series for backtesting
- → No competing product offers this signal — full methodology →
GET /v1/divergence/current
// Response
{
“request_id”: “c360-9d19-42a3…”,
“as_of”: “2026-06-09T14:32:00Z”,
“meta”: { “period”: “24h” },
“data”: {
“gap_pp”: 38.4,
“who_leads”: “crypto_native”,
“signal_strength”: “strong”,
“confidence”: “high”,
“mainstream”: {
“articles”: 18,
“bullish_pct”: 39.0
},
“crypto_native”: {
“articles”: 32,
“bullish_pct”: 77.4
}
}
}
Pricing
Choose your plan.
All plans include the Divergence Index endpoint, full JSON responses, and commercial use rights.
Developer
Try the API and integrate at your own pace.
$49
/month
200 requests / day
- ✓All 16 endpoints
- ✓/v1/divergence/current
- ✓Real-time data
- ✓JSON responses
- ✓Commercial use
- ✓Email support
- –Historical data
- –Webhooks
Starter
For live systems with moderate API demand.
$149
/month
1,000 requests / day
- ✓Everything in Developer
- ✓Ticker intelligence endpoints
- ✓Historical data (30 days)
- ✓Priority email support
- –Webhooks
- –Dedicated support
Most popular
Pro
For production systems and algorithmic strategies.
$349
/month
10,000 requests / day
- ✓Everything in Starter
- ✓Full historical data
- ✓Webhook notifications
- ✓Telegram/Slack alerts
- ✓CSV / Parquet export
- ✓Dedicated support
Enterprise
Unlimited access, SLA, and white-label option.
$999
/month
Unlimited requests
- ✓Everything in Pro
- ✓White-label option
- ✓99.5% uptime SLA
- ✓Custom integrations
- ✓Direct line to founder
- ✓Invoice billing
What’s included
16 endpoints. Built for real use cases.
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. Filterable by ticker.
GET
/v1/divergence/history
Daily divergence gap series with configurable date range and incremental polling cursor.
GET
/v1/divergence/by-ticker new
Tickers ranked by widest mainstream vs crypto-native disagreement right now.
GET
/v1/divergence/accuracy new
Historical directional hit-rate of the HafidWatch signal — queryable track record.
GET
/v1/sentiment/current
24h market sentiment with HafidWatch Score and period-over-period deltas vs prior 24h.
GET
/v1/sentiment/history
Sentiment time series — daily or weekly granularity, filterable by ticker.
GET
/v1/sentiment/by-category
Sentiment breakdown by narrative category — Markets, DeFi, Macro, Regulation, AI.
GET
/v1/sentiment/ticker/{ticker} new
Current sentiment for a single ticker — mentions, dominant signal, avg score.
GET
/v1/tickers/trending
Top tickers by media mentions with sentiment breakdown. Configurable period.
GET
/v1/tickers/{ticker}/sentiment
Historical daily sentiment for a specific ticker — bullish/bearish trend over time.
GET
/v1/tickers/{ticker}/articles
Most recent articles mentioning a ticker with full AI metadata.
GET
/v1/signals/latest
Latest alerts from the signal engine with incremental polling via
since cursor.
GET
/v1/signals/history
Signal history with frequency analysis by alert type over configurable window.
GET
/v1/market/snapshot
All market signals in one call — HafidWatch Score, sentiment, BTC price, F&G, funding rate.
GET
/v1/market/sources/leaderboard
Sources ranked by average signal quality and sentiment breakdown. Weekly ranking.
GET
/v1/usage
Your plan, daily request limit, usage today, remaining quota, and reset time.
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 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
Request your free trial key →
We respond within a few hours. No credit card required.
View API docs