Real-time financial news — ticker-tagged, sentiment-scored, categorized, over WebSocket and REST.
H1 News API is HeliusOne's own news engine. It aggregates 130+ sources — market news, press-release wires, central banks, regulators, trading halts, SEC filings, global events, and markets across the Americas, Europe and Asia-Pacific — 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
One consistent feed — live and historical
A true push feed — subscribe to the tickers, categories, sources, languages and regions you care about and receive normalized articles the moment they are ingested. Change filters live on the open socket. For browser apps, mint a short-lived stream token server-side so your key never ships to the client.
Every story is classified — markets, earnings, macro, world, commodities, forex, crypto, trading halts, SEC filings, regulatory. Dedicated endpoints for earnings, halts, filings and central-bank news, plus include/exclude category filters everywhere.
Nasdaq trading halts with reason codes (~20s latency) — the purest "something is happening to this ticker" signal — 8-K, Form 4, S-1, SC 13D and 10-Q filings as structured news, and the regulators that move single names: FDA approvals, SEC and FTC actions, CFTC and the UK FCA.
Each story is scored positive, neutral, or negative at ingest by a finance-tuned model (FinBERT), with an event-rule overlay that corrects market-direction cases the tone model misreads — a buyback is good news, a guidance cut is not. Filter the stream to just the negative headlines on a name, or track sentiment over time.
Symbols come from the SEC universe (~10k tickers) and are matched three ways — $CASHTAG, bare symbol, and multi-word company name ("Berkshire Hathaway") — with curated brand aliases. Syndicated copies of the same story are de-duplicated across sources so one event is one article.
Articles carry an ISO language code (declared for single-language editions, detected for mixed feeds) and a source region — us, uk, eu, jp, br, mx, latam, ca, au, in, cn, asia, global. Keep your feed English-only, or slice by the market that moves your book.
The same filters as the stream — ticker (any or all), curated baskets like MAG7 and Semiconductors, category, sentiment, language, region, source, type, full-text search with AND/OR, date presets — over the full stored history, with CSV export, lookup by id and gapless since_id backfill for reconnects.
Daily sentiment breakdown per ticker or for the whole market, a most-mentioned ticker ranking over any window, the upcoming earnings calendar, analyst rating trends, and a Claude-generated Sundown Digest of the day — generated with your own AI key and cached for every caller.
Stream live over WebSocket, query history over REST — every endpoint takes the same filters
Live feed. Filter by tickers, categories, sources, types, languages, regions — server-side, and change them on the open socket.
Mint a short-lived stream token from your server so a browser can connect directly without ever seeing your key.
Query history with every filter the stream supports, plus full-text search, date presets, and CSV export.
Earnings news: results wires, earnings coverage, and query feeds. Calendar companion below.
Nasdaq trading halts & resumptions with reason codes, tagged to the exact symbol.
Central-bank & economy news — Fed, ECB, BoE, BoJ, CFTC — filterable by source.
SEC filings as structured news — filter by form: 8-K, Form 4, S-1, SC 13D, 10-Q.
Any category as its own feed — regulatory, crypto, commodities, world, and the rest.
Daily sentiment breakdown for one ticker or the whole market over any preset window.
Most-mentioned tickers across the feed — a live attention ranking for any window.
Upcoming earnings dates up to 60 days out, filterable to a symbol.
Analyst buy/hold/sell recommendation trends for any ticker.
End-of-day market recap generated with your own AI key, cached daily for every caller.
Your plan, monthly quota, and usage — never counted against your quota.
Plus /v1/news/general, /v1/news/{id}, /v1/categories, /v1/tickers?search=, /v1/sources, and a public /health (status page).
Interactive reference for every endpoint and filter: api.heliusone.com/docs ↗
The stream is a Pro-plan feature. One connection costs one API call — every pushed article is free. Basic plans get the same articles by polling /v1/news?since_id=….
Connect with your key, filtering server-side via query params — tickers, categories, sources / exclude_sources, types, languages, regions:
Change filters live — send a frame; only the keys you send are touched:
Real requests against the live API — pick a preset or compose your own filters, then copy it as curl
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.
The major financial news sources, the wires, the regulators and the central banks — normalized into one schema, de-duplicated across syndicated copies, and enriched. The full list is one authenticated call away at /v1/sources
The major US and international financial dailies and market-news sites, headline coverage from the leading global news agencies, and the three press-release wires — including an earnings-only slice that is often first to break results and M&A.
Federal Reserve, ECB, Bank of England, Bank of Japan and Bank of Canada on a ~20-second tier; Reserve Bank of Australia and Reserve Bank of India. SEC press releases and EDGAR filings, FDA approvals and recalls, FTC, CFTC and the UK FCA. Economic releases from the BEA, Census Bureau, EIA, ONS and the European Commission.
International broadcasters and world-affairs desks for the geopolitics that moves markets; dedicated commodities, energy, forex and crypto outlets for the sectors.
The UK financial press and the leading business desks of Germany, France, Italy, Spain, the Netherlands and Ireland — in English and in their own languages. Filter with region=uk or eu.
The leading English-language business outlets of Japan, China and Hong Kong, India, Singapore, the Philippines and Australia. Filter with region=jp, cn, in, asia or au.
Canada's national business press; Brazil's and Mexico's leading financial outlets in Portuguese and Spanish plus their English-language editions; region-wide Latin American coverage. Filter with region=ca, br, mx or latam.
Source names appear in API responses and in /v1/sources only to identify feeds. Publisher and product names are trademarks of their respective owners; no affiliation, sponsorship or endorsement is implied. Every article links to its publisher.
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.
For prototyping, research tools, and small apps
Card required · 5-day / 100-call free trial · cancel anytime
For production apps and trading tools
Card required · 5-day / 100-call free trial · cancel anytime
Need custom volume, rate limits, SLAs, or dedicated sources? Talk to us.
Runnable walkthroughs for the things people build first
Stream ticker-tagged, sentiment-scored headlines in Python in under 20 lines, with reconnects and gapless backfill. Filters for tickers, categories, sources and regions.
A regulatory category that carries FDA approvals, complete response letters and recalls tagged to the ticker, plus SEC, FTC, CFTC and FCA actions. One filter, REST or stream.
Get Nasdaq trading halts and resumptions ~20 seconds after the exchange posts them, with T1/T2/LUDP reason codes, tagged to the exact symbol, over REST or WebSocket.
Filter financial news by region — br, mx, latam, in, cn, jp, asia, au, ca, uk, eu — and language, with the local financial press in Portuguese, Spanish, German, French and more.
Give an LLM agent ticker-tagged, sentiment-scored news it can reason over: an MCP server for Claude and Cursor, LangChain tools, and compact JSON that fits a context window.
Open source: Python SDK · TypeScript SDK · MCP server · examples & Postman
Your API key, live usage, and billing live in your API account.
Open My API AccountQuestions or custom-volume inquiries: support@heliusone.com