Endpoints
All endpoints
The API surface at a glance — one schema, one SQL grammar. The exhaustive machine-readable contract, including utility endpoints, is the OpenAPI spec.
Tickers
One ticker, one moment: current state, point-in-time snapshot, ETF composition.
| Method | Path | Summary |
|---|---|---|
| GET | https://api.tickerbot.io/ | The symbol directory: every tracked ticker, alphabetical, paginated. |
| GET | https://api.tickerbot.io/ | Get the full current state of one ticker. |
| GET | https://api.tickerbot.io/ | The full ticker row as it stood at a past moment. |
| POST | https://api.tickerbot.io/ | Create a webhook that fires when this ticker matches a query. |
| GET | https://api.tickerbot.io/ | What data exists for a ticker — spans per resolution + measured per-field depth. |
| GET | https://api.tickerbot.io/ | Constituent holdings of an ETF, weight-ranked. |
| GET | https://api.tickerbot.io/ | Sector allocation of an ETF, weight-ranked. |
Signals
What signals exist and who matches one right now (or at a past moment).
| Method | Path | Summary |
|---|---|---|
| GET | https://api.tickerbot.io/ | Built-in signals plus your custom signals, each tagged with `kind`. |
| GET | https://api.tickerbot.io/ | Find the tickers where a signal is true right now. |
| GET | https://api.tickerbot.io/ | Run the match set at any past moment — same endpoint as live, with ?asof=. |
| POST | https://api.tickerbot.io/ | Create a webhook that fires when any ticker matches this signal. |
Scan
Many tickers, one moment — a SQL WHERE across the live universe or a past instant.
| Method | Path | Summary |
|---|---|---|
| POST | https://api.tickerbot.io/ | Run a SQL WHERE against the current universe. |
| POST | https://api.tickerbot.io/ | Run a SQL WHERE against any past moment — same endpoint as live, with `asof` set. |
| POST | https://api.tickerbot.io/ | Create a webhook that fires when any ticker matches an arbitrary WHERE clause. |
Series
Ticker state over time on one aligned grid — any columns, any tickers, plus the chart feed.
| Method | Path | Summary |
|---|---|---|
| GET | https://api.tickerbot.io/ | Any columns for any tickers on one aligned time grid — the canonical series read. |
| GET | https://api.tickerbot.io/ | The chart feed: OHLCV bars in a compact array shape, down to 1-second. |
Events
Discrete things that happened — one cross-ticker timeline, one row per kind, plus the spans shape.
| Method | Path | Summary |
|---|---|---|
| GET | https://api.tickerbot.io/ | One timeline over every event log: dividends, splits, insider transactions, analyst actions — plus opt-in signal firings and news. |
| POST | https://api.tickerbot.io/ | Webhook on new dividends, splits, insider filings, or analyst actions. |
| GET | https://api.tickerbot.io/ | Cash-dividend declarations on the unified timeline; doubles as a dividend calendar. |
| GET | https://api.tickerbot.io/ | Stock splits and reverse splits, timestamped at the execution date. |
| GET | https://api.tickerbot.io/ | Officer and director trades (Form 4 activity). |
| GET | https://api.tickerbot.io/ | Upgrades, downgrades, initiations, and price-target changes; hourly, 24/7. |
| GET | https://api.tickerbot.io/ | Headlines as events on the timeline (opt-in); /v2/news stays the search surface. |
| GET | https://api.tickerbot.io/ | Boolean-flag flips as enter/exit point-events (opt-in). |
| GET | https://api.tickerbot.io/ | Run-length-encoded occurrences — windows for state flags, points for event flags. |
News
SQL query over the news archive: article rows or rollups by ticker, day, source, or sentiment.
| Method | Path | Summary |
|---|---|---|
| GET | https://api.tickerbot.io/ | SQL query over the news_article archive. Returns articles or aggregate rollups. |
Custom signals
Named boolean predicates you author and reference like a built-in.
| Method | Path | Summary |
|---|---|---|
| POST | https://api.tickerbot.io/ | Save a named boolean SQL predicate you can reference like a built-in signal. |
| PATCH | https://api.tickerbot.io/ | Edit the expression or description of one of your custom signals. |
| DELETE | https://api.tickerbot.io/ | Remove a custom signal — refused by default if anything references it. |
Universes
Named ticker lists you reference from any query endpoint with ?universe=<slug>. Built-in and custom come from one list (?owner=).
| Method | Path | Summary |
|---|---|---|
| POST | https://api.tickerbot.io/ | Create a universe. |
| GET | https://api.tickerbot.io/ | Fetch a single universe. |
| GET | https://api.tickerbot.io/ | Get all universes — yours, the built-in system ones, or both. |
| PATCH | https://api.tickerbot.io/ | Update a universe. |
| DELETE | https://api.tickerbot.io/ | Delete a universe. |
Webhooks
A trigger plus a delivery. POST /v2/webhooks is canonical; the /subscribe shortcuts build the identical webhook.
| Method | Path | Summary |
|---|---|---|
| POST | https://api.tickerbot.io/ | Canonical create: a webhook is a trigger plus a delivery. |
| GET | https://api.tickerbot.io/ | Fetch one webhook subscription. |
| GET | https://api.tickerbot.io/ | List every webhook subscription on this account. |
| PATCH | https://api.tickerbot.io/ | Edit a webhook subscription in place. |
| DELETE | https://api.tickerbot.io/ | Delete a webhook subscription. |
| POST | https://api.tickerbot.io/ | Re-enable a disabled webhook. |
| POST | https://api.tickerbot.io/ | Send a real-shape test POST to your endpoint, instantly. |
| GET | https://api.tickerbot.io/ | Inspect recent deliveries for a webhook. |
Websockets
Real-time ticker updates over a websocket, plus your stream usage.
| Method | Path | Summary |
|---|---|---|
| WSS | https://api.tickerbot.io/ | Hold a socket open and receive each subscribed ticker's freshly-computed row on every refresh. |
| GET | https://api.tickerbot.io/ | Current WebSocket streaming consumption vs your account cap. |