Stream tickers
wss://api.tickerbot.io/ v2/ streamStreams each ticker's latest values over a held-open websocket, within the minute.
Subscribe parameters
string[]requiredOne symbol or a list (a JSON array or a comma-separated string), on a subscribe or unsubscribe frame. Up to 200 per frame; send more frames to add more, capped per account. A symbol we do not track comes back in the ack's not_found, a crypto, FX or rate symbol in unsupported, a malformed one in invalid; a frame where every symbol is malformed or unsupported is an error frame naming them.
string[] | '*'Signals in each update. Omit for the default minute set; "*" sends every live signal; a list selects those (a signal renamed at the 2026-09-07 cutover with its values unchanged is served under its new name and listed in renamed_signals; a list naming any signal the stream does not carry is an error frame naming them, and nothing is subscribed).
Server messages
| Frame | Meaning |
|---|---|
authed | Key accepted. Carries your resolved plan. Wait for this ack before sending subscribe: a frame that arrives while auth is still resolving is rejected with auth_required, so sending auth and subscribe back-to-back in onopen races. |
subscribed | Acks a subscribe: tickers (added or already subscribed) and count (distinct tickers on the account), plus, when present, not_found (symbols we do not track; no cap slot used), unsupported (crypto, FX and rate symbols), invalid (malformed symbols), rejected (over cap) and renamed_signals ([{ requested, use }]). |
update | One ticker's state: { ticker, as_of, data }, sent each time the data refreshes (about twice a minute in market hours). |
unsubscribed | Acks an unsubscribe frame. |
pong | Reply to a ping frame. |
Error frames
| Frame | Meaning |
|---|---|
auth_required | First message was not a valid auth frame and no Bearer header was sent. The socket closes. |
auth_timeout | No credential arrived within 10 seconds of connecting. The socket closes (1008). |
unauthenticated | Malformed, unknown or revoked API key. |
bad_json | A frame was not valid JSON. |
unknown_type | A frame's type is not one of auth/subscribe/unsubscribe/ping. |
bad_request | ticker missing or empty, every symbol malformed or unsupported, more than 200 symbols in one subscribe frame, or a select naming a signal the stream does not carry (the message names each one, with a did-you-mean) or nothing at all. |
unknown_parameter | A subscribe or unsubscribe frame carried a key that names another param. The message names the key and what to send instead: select for a list of signals, ticker for symbols, GET /v2/tickers/{ticker}?asof= for asof (the stream is live only). |
subscription_limit | You are subscribed to N of M tickers on your plan. Unsubscribe some or upgrade to add more. Over-cap tickers come back in the subscribed ack's rejected list (the error frame arrives before the ack). The frame carries plan and upgrade_url. On Free the cap is 0. |
too_many_connections | Max 5 concurrent stream connections per account, pooled across every API key on the account. An abuse guard, not a plan limit. |
connection_closed | The socket closed before authentication completed. |
internal | Unexpected server error; the socket closes with 1011. |
Notes
- An
updateframe carries the signals you chose from the same record asGET /v2/tickers/{ticker}, per minute from 4 AM to 8 PM ET on weekdays. Equities and ETFs only: a crypto, FX or rate symbol comes back in the ack'sunsupported. When the market is closed the values do not change; frames may repeat the last row. - Caps are per account. Concurrent distinct tickers are pooled across every live connection your account holds, whatever key each uses, and two connections subscribed to the same symbol cost one slot. Unsubscribing or disconnecting frees slots immediately: the cap counts what is subscribed now. Check current consumption with
GET /v2/stream/usage. - Authenticate with
Authorization: Bearerat the handshake, or send an auth frame as the first message:{type:"auth", api_key}or{type:"auth", id_token}from a signed-in browser session. - Client frames:
{type:"auth", …},{type:"subscribe", ticker, select?},{type:"unsubscribe", ticker},{type:"ping"}. A key that names another param (a list of signals, symbols, orasof) is anunknown_parametererror frame naming it and what to send instead (the stream is live only, soasofpoints at Get a ticker). Any other key is ignored until 2027-01-12, then answers the same error (see Deprecations). A partially-rejected subscribe emits itserrorframe before thesubscribedack it refers to. - A symbol we do not track comes back in the ack's
not_foundand takes no slot of your cap. - Keepalive and backpressure: the server pings every 30 seconds and terminates unresponsive peers. A slow consumer with over 4 MB buffered silently loses the rest of that tick's updates; past 16 MB the socket closes with
1013. - Close codes:
1008policy/auth (bad key, auth timeout, connection cap),1011internal error,1013slow consumer.