tickerbot.io

Stream tickers

WSSwss://api.tickerbot.io/v2/stream

Streams each ticker's latest values over a held-open websocket, within the minute.

string[]required

One 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).

FrameMeaning
authedKey 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.
subscribedAcks 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 }]).
updateOne ticker's state: { ticker, as_of, data }, sent each time the data refreshes (about twice a minute in market hours).
unsubscribedAcks an unsubscribe frame.
pongReply to a ping frame.
FrameMeaning
auth_requiredFirst message was not a valid auth frame and no Bearer header was sent. The socket closes.
auth_timeoutNo credential arrived within 10 seconds of connecting. The socket closes (1008).
unauthenticatedMalformed, unknown or revoked API key.
bad_jsonA frame was not valid JSON.
unknown_typeA frame's type is not one of auth/subscribe/unsubscribe/ping.
bad_requestticker 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_parameterA 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_limitYou 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_connectionsMax 5 concurrent stream connections per account, pooled across every API key on the account. An abuse guard, not a plan limit.
connection_closedThe socket closed before authentication completed.
internalUnexpected server error; the socket closes with 1011.
  • An update frame carries the signals you chose from the same record as GET /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's unsupported. 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: Bearer at 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, or asof) is an unknown_parameter error frame naming it and what to send instead (the stream is live only, so asof points 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 its error frame before the subscribed ack it refers to.
  • A symbol we do not track comes back in the ack's not_found and 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: 1008 policy/auth (bad key, auth timeout, connection cap), 1011 internal error, 1013 slow consumer.