Standalone Product · Public Beta

H1 News API

Real-time financial news — ticker-tagged, sentiment-scored, categorized, over WebSocket and REST.

H1 News API is HeliusOne's own news engine. It aggregates 65+ sources — market news, press-release wires, central banks, trading halts, SEC filings, global events, and Latin American markets — normalizes them into one schema, tags tickers, scores sentiment, and fans them out live. It's the same feed that powers the HeliusOne terminal.

5-day free trial on every plan · cancel anytime

What You Get

One consistent feed — live and historical

Real-Time WebSocket Streaming

A true push feed — subscribe to the tickers, categories, and sentiment you care about and receive normalized articles the millisecond they are ingested. No polling, no refresh loops, no rate-limit roulette.

Topic Categories on Every Article

Every story is classified — markets, earnings, macro, world, commodities, forex, crypto, trading halts, SEC filings. Dedicated endpoints for earnings, halts, and central-bank news, plus category filters everywhere.

Trading Halts & SEC Filings

Nasdaq trading halts with reason codes (~20s latency) — the purest "something is happening to this ticker" signal — plus 8-K, Form 4, S-1, SC 13D, and 10-Q filings surfaced as structured news.

Sentiment on Every Article

Each story is scored positive, neutral, or negative at ingest with a numeric value attached. Filter the stream to just the negative headlines on a name, or track sentiment shifts over time.

Language & Region Tagged

Articles carry an ISO language code (detected for mixed-language feeds) and a source region — us, uk, eu, jp, br, mx, latam, global. Keep your feed English-only, or slice by the market that moves your book — Brazil and Mexico included.

Queryable REST History

The same filters as the stream — ticker, category, sentiment, language, region, source, full-text search with AND/OR — over the full stored history, with CSV export and gapless since_id backfill for reconnects.

A Simple, Predictable API

Stream live over WebSocket, query history over REST — every endpoint takes the same filters

WS /v1/stream WebSocket

Live feed. Filter by tickers, categories, sentiment, sources, types, languages, regions — server-side.

GET /v1/news REST

Query history with every filter the stream supports, plus full-text search, date presets, and CSV export.

GET /v1/news/earnings REST

Earnings news: results wires, earnings coverage, and query feeds. Calendar companion below.

GET /v1/news/halts REST

Nasdaq trading halts & resumptions with reason codes, tagged to the exact symbol.

GET /v1/news/macro REST

Central-bank & economy news — Fed, ECB, BoE, BoJ, CFTC — filterable by source.

GET /v1/news/filings REST

SEC filings as structured news — filter by form: 8-K, Form 4, S-1, SC 13D, 10-Q.

GET /v1/sentiment REST

Daily sentiment breakdown for one ticker or the whole market over any preset window.

GET /v1/top-mentioned REST

Most-mentioned tickers across the feed — a live attention ranking for any window.

GET /v1/earnings-calendar REST

Upcoming earnings dates up to 60 days out, filterable to a symbol.

GET /v1/ratings REST

Analyst buy/hold/sell recommendation trends for any ticker.

GET /v1/sundown-digest REST

End-of-day market recap generated with your own AI key, cached daily for every caller.

GET /v1/usage REST

Your plan, monthly quota, and usage — never counted against your quota.

Plus /v1/news/general, /v1/news/category/{category}, /v1/categories, /v1/tickers, and /v1/sources.

Interactive reference for every endpoint and filter: api.heliusone.com/docs ↗

h1-news-api
# Stream earnings news and trading halts for a basket, live
ws wss://api.heliusone.com/v1/stream?api_key=…&tickers=AAPL,TSLA&categories=earnings,halts
// pushed in real time, the moment it's ingested
{
  "title": "Trading halt: TSLA — Tesla Inc (NASDAQ, T1: news pending)",
  "tickers": ["TSLA"],
  "category": "halts",
  "sentiment": {"label": "neutral", "score": 0.0},
  "language": "en", "region": "us",
  "source": "Nasdaq Trade Halts",
  "published_at": "2026-07-03T13:41:09Z"
}
# Query history over REST — same filters everywhere
curl 'https://api.heliusone.com/v1/news?ticker=AAPL&category=earnings&sentiment=positive&language=en'
curl 'https://api.heliusone.com/v1/news/macro?source=European%20Central%20Bank'

Streaming in 60 seconds

The stream is a Pro-plan feature. One connection costs one API call — every pushed article is free.

Connect with your key, filtering server-side via query params — tickers, categories, sources / exclude_sources, types, languages, regions:

wss://api.heliusone.com/v1/stream?api_key=…&tickers=AAPL&regions=us,br

Change filters live — send a frame; only the keys you send are touched:

{"action":"subscribe","categories":["earnings","halts"]}
  • Messages — one article per frame, identical JSON shape to /v1/news results. Only articles published in the last 24h are pushed; older backlog lands in REST history only.
  • Keepalive — send {"action":"ping"} anytime; you'll get a pong back.
  • Close codes1008 invalid key · 4403 plan doesn't include streaming (a JSON frame explains before closing).
  • Reconnect without gaps — after any disconnect, reconnect and backfill with GET /v1/news?since_id=<last id seen>.

Try It Right Now

Real requests against the live API — pick a preset or compose your own filters, then copy it as curl

GET https://api.heliusone.com/v1/news?ticker=AAPL&limit=5
Full API docs ↗

Live requests hit the production API with a shared, rate-limited demo key — responses are real and current. The demo runs Basic-plan rules: one ticker per call, last 30 days.

Aggregated From 65+ Sources

Normalized into one schema, de-duplicated, and enriched

Markets & Wires

Yahoo Finance, MarketWatch real-time headlines, Nasdaq, CNBC, Seeking Alpha, WSJ & FT Markets, NYT Business, The Economist, Business Insider, TheStreet, Fortune, Forbes — plus PR Newswire and GlobeNewswire, including an earnings-only wire slice, and Reuters headlines via wire partners.

Central Banks & Regulators

Federal Reserve, ECB, Bank of England, Bank of Japan, and CFTC press releases on a ~20-second low-latency tier, plus SEC EDGAR material-event filings.

Global Events & Sectors

BBC World, Al Jazeera, Guardian, NPR, Nikkei Asia, and the GDELT global event monitor for geopolitics; commodities, energy, forex, and crypto coverage from OilPrice, Investing.com, CoinDesk, and Cointelegraph.

Brazil, Mexico & LatAm

InfoMoney, G1 Economia, Exame, Money Times, and Brazil Journal for Brazil; El Financiero and Expansión for Mexico; Bloomberg Línea and MercoPress region-wide — plus English-language coverage from Rio Times, Agência Brasil, and Mexico News Daily. Filter with region=br, mx, or latam.

Pricing

Simple monthly plans

Every plan starts with a 5-day free trial (100 calls, all features of your chosen plan). Your API key is provisioned the moment checkout completes. One call = one request, no matter how much it returns.

Basic
$19.99/mo

For prototyping, research tools, and small apps

  • 20,000 API calls / month
  • REST news history — last 30 days
  • One ticker per call
  • Ticker, source, type & sentiment filters
  • Category, language & region filters
  • 60 requests / minute
  • Community support

Card required · 5-day / 100-call free trial · cancel anytime

Most popular
Pro
$49.99/mo

For production apps and trading tools

  • 50,000 API calls / month
  • Everything in Basic
  • Live WebSocket stream with server-side filters
  • Multi-ticker queries (up to 25 per call)
  • Full news archive & unlimited paging
  • Trading-halt, earnings & macro feeds
  • Top-mentioned tickers & sentiment analytics
  • Sundown Digest endpoint — generate with your own AI key
  • 300 requests / minute
  • Priority support

Card required · 5-day / 100-call free trial · cancel anytime

Need custom volume, rate limits, SLAs, or dedicated sources? Talk to us.

Already subscribed?

Your API key, live usage, and billing live in your API account.

Open My API Account

Questions or custom-volume inquiries: support@heliusone.com