Feeds channel
Subscribe to the real-time WebSocket stream of scored feed items.
The feeds channel pushes scored news and filings the moment they're
published — the same items you'd poll from GET /v1/feeds,
delivered in real time over WebSocket.
Connect
wss://stream.forecite.com/v1/feedsAuthenticate by sending your API key in the first message after the socket opens:
{ "type": "auth", "token": "fc_live_your_key_here" }Subscribe
{ "type": "subscribe", "filters": { "symbols": ["NVDA", "TSLA"], "actionable": true } }Messages
Each scored item arrives as an item event with the same shape as a REST feed
item:
{
"type": "item",
"data": {
"id": "0b3f...",
"title": "Q3 EPS $4.93 vs $4.59 est; FY guide raised",
"scoring": { "actionability": true, "sentiment_score": 8 },
"symbols": [{ "symbol": "NVDA", "exchange": "NASDAQ" }]
}
}Heartbeats
The server sends a ping every 30s; reply with pong to keep the connection
alive. Reconnect with backoff on disconnect.