Free News Sentiment API
The FOMOGRAM Free News Sentiment API delivers real-time financial headlines and quantitative market sentiment streaming from 500+ verified global media outlets. Every story is stripped of speculative noise and evaluated by Sentinel AI to produce algorithmic sentiment scores (-100 to +100) and market directions (Bullish, Bearish, or Neutral).
Engineered for algorithmic trading bots, quantitative backtesters, newsroom CMS platforms, and financial LLMs. Query instantly with zero authentication—no API key, signup, or credit card required.
100% Free & Instant
Zero authentication. No sign-up forms, credit cards, or API keys required to start streaming live sentiment.
Quantitative Sentiment
Dual-refereed AI assigns normalized scores from -100 (Max Bearish) to +100 (Max Bullish) to eliminate NLP latency.
5W1H Journalistic Lede
Structured narrative summaries (Who, What, When, Where, Why, How) ready for instant LLM and trading decisions.
Multi-Asset Wire
Covers Cryptocurrencies, US Tech Equities, Commodities (Gold/Oil), and Borsa İstanbul (BIST) from 500+ feeds.
Live Endpoint & Quickstart
curl -X GET "https://www.fomogram.app/api/news?symbol=BTC&limit=20" \
-H "Accept: application/json"20 items)Content-Type: application/json{
"success": true,
"timestamp": "2026-10-10T22:30:00.000Z",
"count": 20,
"articles": [
{
"id": "bitcoin-etf-outflows-weekly-redemptions",
"title": "Bitcoin Breaks Three-Week ETF Inflow Streak With Over $680 Million Withdrawn",
"symbol": "BTC",
"direction": "negative",
"score": -80,
"impact": "high",
"isHardCatalyst": true,
"sourceName": "Bloomberg Crypto",
"createdAt": "2026-10-10T16:20:00.000Z",
"summary": "U.S. spot Bitcoin ETFs recorded $681.1 million in net withdrawals over five sessions, breaking a three-week streak of institutional inflows led by redemptions in major custody vaults.",
"marketCategory": "CRYPTO",
"briefing": {
"keyEvent": "Spot Bitcoin ETFs recorded $681.1 million in net weekly outflows, ending three consecutive weeks of inflows.",
"technicalContext": "Institutional redemptions concentrated across major regulated custodian trusts.",
"marketImpact": "Near-term spot price compression as secondary liquidity absorbs redemption balancing."
},
"whyItMatters": "Highlights short-term institutional profit-taking following resistance rejection."
},
{
"id": "uniswap-v4-v3-47-stablecoin-dex-volume",
"title": "Uniswap v4 and v3 capture 47.2% of $161.4 billion in stablecoin DEX volume",
"symbol": "UNI",
"direction": "positive",
"score": 70,
"impact": "high",
"isHardCatalyst": true,
"sourceName": "Crypto Briefing",
"createdAt": "2026-10-10T17:57:03.000Z",
"summary": "Uniswap v4 and v3 together accounted for 47.2% of the $161.4 billion in stablecoin trading on decentralized exchanges over the past 30 days, solidifying its critical role in on-chain finance.",
"marketCategory": "CRYPTO"
}
]
}Query Parameters Reference
symbolstringFilters news for a specific asset ticker (e.g. BTC, ETH, SOL, NVDA, XAU, or BIST). If omitted, returns real-time news across all tracked financial markets.
limitintegerNumber of recent articles to return (range: 1 - 500). Defaults to 20.
modestringPayload density mode. Use full for 5W1H journalistic summaries and editorial briefings. Use compact for high-throughput ticker widgets (id, title, score, direction, symbol).
alertsbooleanWhen set to true, returns exclusively high-conviction Hard Catalyst news (|score| >= 80) eligible for push notifications.
includeSignalsbooleanWhen set to true, attaches active quantitative signal setups for the queried asset within the payload.
| Parameter | Type | Default | Description |
|---|---|---|---|
| symbol | string | Optional (All) | Filters news for a specific asset ticker (e.g. BTC, ETH, SOL, NVDA, XAU, or BIST). If omitted, returns real-time news across all tracked financial markets. |
| limit | integer | 20 (max 500) | Number of recent articles to return (range: 1 - 500). Defaults to 20. |
| mode | string | "full" | Payload density mode. Use full for 5W1H journalistic summaries and editorial briefings. Use compact for high-throughput ticker widgets (id, title, score, direction, symbol). |
| alerts | boolean | false | When set to true, returns exclusively high-conviction Hard Catalyst news (|score| >= 80) eligible for push notifications. |
| includeSignals | boolean | false | When set to true, attaches active quantitative signal setups for the queried asset within the payload. |
Rate Limits & Error Handling
To prevent resource exhaustion, protect infrastructure, and ensure low latency for all consumers, public API calls are subject to strict per-minute sliding window rate limits.
Every external IP address is allocated at most 1 request per 10-second sliding window (maximum 6 calls per minute). If requests are fired more frequently than every 10 seconds, the server immediately returns HTTP 429 Too Many Requests with a Retry-After countdown.
{
"success": false,
"error": "Rate limit exceeded. Maximum 1 request per 10 seconds allowed.",
"message": "Too many requests from this IP. Please wait 7 seconds before retrying.",
"limit": 1,
"remaining": 0,
"retryAfter": 7
}429 status, pause your requests for the duration indicated by retryAfter or inspect the Retry-After header before re-querying.Quantitative Sentiment Calibration
FOMOGRAM eliminates subjective crypto commentary by classifying articles through dual-refereed LLM heuristics.
Market Noise & Speculation
Price predictions, op-eds, or repetitive commentary are automatically assigned a quantitative score of 0.
Ecosystem Developments
New merchant integrations, secondary partnership releases, or moderate volume shifts.
Macro Shifts & Liquidations
Verifiable capital inflows/outflows, SEC/DOJ actions, network upgrades, or large on-chain liquidations.
Frequently Asked Questions (FAQ)
Essential integration guides, scoring calibrations, and developer questions regarding the free news sentiment API.
Is the FOMOGRAM News Sentiment API completely free?
Yes. FOMOGRAM provides a 100% free public REST tier. There are no subscription fees, credit cards, or hidden paywalls. Anyone can make up to 1 request per 10-second sliding window without any credentials.
Do I need an API key to access this endpoint?
No API key is required. The public endpoint /api/news is open for direct HTTP GET requests. Simply pass query parameters like ?symbol=BTC or ?limit=20.
How are news sentiment scores calculated?
Sentinel AI evaluates incoming articles against a dual-refereed institutional taxonomy. Scores range from -100 (Extremely Bearish / High Liquidation Risk / Severe Outflows) to +100 (Extremely Bullish / Massive Inflows / Approvals). Speculative commentary and opinion pieces are calibrated to 0 (Neutral).
Which asset classes are supported by the API?
The API continuously monitors over 500 verified sources covering Cryptocurrencies (BTC, ETH, SOL, XRP, DOGE, etc.), Precious Metals & Commodities (Gold XAU, Silver XAG, Brent Oil BZ), US Equities (NVDA, TSLA, AAPL, MSFT, COIN, MSTR), and Borsa İstanbul (BIST).
How do algorithmic trading bots use this data?
Trading algorithms inspect the normalized score and isHardCatalyst boolean fields to trigger event-driven orders, widen stop-losses ahead of high-impact catalysts, or pause automated market making during macro shocks.
What happens if I exceed the rate limit?
If an IP exceeds 1 request per 10 seconds, the server returns HTTP 429 Too Many Requests with a Retry-After countdown header. Simply pause your requests until the countdown expires.
Need Dedicated WebSocket Streams or Custom Webhooks?
For newsrooms requiring sub-second push feeds, custom webhook dispatchers, or enterprise SLA throughput, contact our engineering desk for tailored keys and dedicated endpoints.