View as markdown
Endpoints · Signals

Signal history

GEThttps://api.tickerbot.io/v2/signals/{signal}/{ticker}/history/{interval}

Returns a sequence of {t, v} bars for the requested signal × ticker at the chosen resolution. t is an ISO timestamp (or YYYY-MM-DD for daily/weekly). v is the signal value at that bar (a number for numeric signals, true/false for boolean flags).

Plan access

Included on every plan.

Rate limit

Hobby 600/min · Pro 6,000/min · Scale 60,000/min.

History

Replayable on every plan.

Query parameters

stringrequired

A column on the wide-state tables (matches the schema page 1:1).

stringrequired

Ticker symbol.

stringrequired

Resolution. Daily-only signals (SMAs, RSI, MACD, fundamentals) are not stored at minute/hourly resolution; request `1d` for those. Minute (`1m`) history is computed for the ~1,000 most-liquid tickers only — a ticker outside that set returns sparse/empty; hourly (`1h`) and daily (`1d`) cover the full universe. `1q` (quarterly) is a distinct surface: it returns per-fiscal-quarter fundamentals for `eps`, `eps_estimate`, `eps_surprise`, `eps_surprise_pct`, `revenue`, `gross_profit`, and `free_cash_flow` (20+ quarters), with `fiscal_period` on each bar.

string

Earliest bar timestamp (inclusive). YYYY-MM-DD or ISO. Defaults to your plan's history window.

string

Latest bar timestamp (inclusive). YYYY-MM-DD or ISO. Defaults to "now".

integerdefault 252

Page size. Max 1000.

string

Opaque cursor. Walks back in time page-by-page from the most-recent bar.

Status codes

200
Page of bars with as_of, count, next_cursor, and bars. Bars are returned in chronological order (earliest first); cursors walk backward through history.
400
Invalid interval, signal not available at the chosen interval, beyond plan history window, or invalid cursor.
401
Missing or invalid API key.