View as markdown
Endpoints · Tickers

Live ticker

GEThttps://api.tickerbot.io/v2/tickers/{ticker}

Returns the entire ticker row. Every field on the schema page, including current values for all numeric signals and the current value of every boolean flag. Pass asof — a YYYY-MM-DD date for the row at the close of that day, or a full ISO timestamp for the row at that intraday moment — see the dedicated [as-of snapshot](/docs/endpoints/tickers/asof) page for frozen-fields and coverage semantics.

Query parameters

stringrequired

Ticker symbol. Case-insensitive. Equities: exchange symbol (`AAPL`). Crypto: X-prefixed pair (`X:BTCUSD`) — bare `BTC`/`ETH` are US-listed ETFs, not spot crypto.

string

Optional. A `YYYY-MM-DD` date returns the row at the close of that day; a full ISO timestamp returns the row at that moment — minute-level where available; `_meta.resolution` reports the granularity served (minute, hourly, or daily). One staleness rule across the whole asof surface: the row must be within the tier's staleness window (14 days for daily) or the ticker 404s with `last_available` — asof answers "the state AT that instant"; for "last known state" read `/history/1d?limit=1`. Plan window: Free reaches back 30 days; every paid plan is unlimited (`403 asof_tier_required` beyond the window). Coverage note: price, technical indicators, and financial-statement fields reconstruct to the exact date; a few vendor-sourced fields (`forward_pe`, `short_interest`, ownership %, analyst estimates) are populated forward-only and may be `null` in older snapshots while historical backfill is in progress — a `null` there means "not yet backfilled," not "no value existed."

Status codes

200
The full ticker row under data. When ?asof= is set, the response also carries _meta.frozen_fields listing the static columns (name, sector, industry, asset_type, exchange) that reflect current values rather than historical.
400
Invalid ticker format or malformed asof.
401
Missing or invalid API key.
404
Ticker not tracked, or no historical row at or before the requested date.