Live News
WSwss://socket.vantafin.com/v1/stocks
Ultimate plan required
WebSocket streams are exclusive to the Ultimate plan. Compare plans and upgrade.
Subscribe to live news and press releases over the same WebSocket connection. Use channel N.{ticker} for a specific ticker (e.g. N.AAPL) or N.* for every article market-wide. Each message is pushed the moment a new article is ingested and carries the headline, body text, publisher, source site, canonical URL, publish time, and a newsType of either 'stockNews' or 'pressRelease'. The news stream runs around the clock - it is not gated to market hours.
Use cases
- Real-time news terminals and breaking-headline tickers
- Event-driven trading on press releases and market-moving news
- Streaming a watchlist's headlines without polling the REST news API
- Feeding NLP / sentiment pipelines as articles are published
Subscribe
Send a subscribe message after connecting. Use N.{ticker} (e.g. N.AAPL) for a single symbol or N.* for every symbol.
{
"action": "subscribe",
"params": "N.AAPL"
}Message fields
| Field | Type | Description |
|---|---|---|
| type | string | Always 'news'. |
| ticker | string | Ticker the article is about. |
| newsType | string | 'stockNews', 'pressRelease', or 'legal'. |
| sourceType | string | Original FMP type when newsType is 'legal' (stockNews | pressRelease). |
| title | string | Headline of the article. |
| text | string | Article body / snippet. |
| publisher | string | Publisher name, e.g. 'Business Wire'. |
| site | string | Source domain, e.g. 'businesswire.com'. |
| url | string | Canonical URL of the article. |
| publishedDate | string | Publish time in UTC (YYYY-MM-DD HH:MM:SS). |
from vantafin import WebSocketClient
ws = WebSocketClient("vf-live-your_api_key")
ws.connect()
ws.subscribe(["N.AAPL"])
for message in ws:
print(message)Official SDKs (Python, JavaScript, Go, Java, Ruby): github.com/vantafin/vantafin
{
"type": "news",
"ticker": "AAPL",
"newsType": "pressRelease",
"title": "Apple Announces Record June Quarter Results",
"text": "Apple today announced financial results for its fiscal third quarter...",
"publisher": "Business Wire",
"site": "businesswire.com",
"url": "https://www.businesswire.com/news/home/20260616/apple-q3-results",
"publishedDate": "2026-06-16 12:30:00"
}