All endpoints
Every route, grouped by family. Every path is on https://api.tickerbot.io.
Scan
Runs a SQL WHERE clause across every ticker and returns the matches, live, as of any past date or as a webhook.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| POST | /v2/scan | tickerbot_scan | Runs a SQL WHERE clause across every ticker, live or as of any past date. |
| POST | /v2/scan/subscribe | tickerbot_subscribe_scan | Creates a webhook that fires when a ticker starts matching a WHERE clause. |
Signals
Lists the signal catalog and returns what one signal is and every ticker matching it, live or as of any past date. Define your own in SQL.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| GET | /v2/signals | tickerbot_list_signals | Lists every signal you can screen on, built-in and custom, filtered and paged. |
| GET | /v2/signals/{signal} | tickerbot_get_signal | Returns one signal's catalog entry and every ticker matching it, live or as of any past date. |
| POST | /v2/signals/{signal}/subscribe | tickerbot_subscribe_signal | Creates a webhook that fires when a ticker starts matching one signal. |
| POST | /v2/signals | tickerbot_create_custom_signal | Saves a named boolean SQL expression you can screen on like a built-in signal. |
| PATCH | /v2/signals/{signal} | tickerbot_update_custom_signal | Edits one of your custom signals: its expression, description or name. |
| DELETE | /v2/signals/{signal} | tickerbot_delete_custom_signal | Deletes a custom signal, unless another of your signals references it. |
Tickers
Lists every ticker and returns everything about one: its signals live or as of any past date, its history from 1m to 1y, OHLCV bars, an ETF's holdings, or a webhook.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| GET | /v2/tickers | tickerbot_list_tickers | Lists every ticker with its identity, alphabetical and paginated. |
| GET | /v2/tickers/{ticker} | tickerbot_get_ticker | Returns everything about one ticker or a comma list of up to 50, live or as of any past date. |
| GET | /v2/tickers/{ticker}/history | tickerbot_get_history | Returns the signals of one ticker or a comma list of up to 50 over time, on one aligned grid. |
| GET | /v2/tickers/{ticker}/bars/{interval} | tickerbot_get_bars | Returns OHLCV bars from 1s to monthly for one ticker or a comma list of up to 50. |
| GET | /v2/tickers/{ticker}/holdings | tickerbot_get_etf_holdings | Returns what an ETF holds and its sector mix, weight-ranked. |
| GET | /v2/tickers/{ticker}/coverage | tickerbot_get_ticker_coverage | Reports how much data a ticker has: spans per grain and depth per signal. |
| POST | /v2/tickers/{ticker}/subscribe | tickerbot_subscribe_ticker | Creates a webhook that fires when this ticker starts matching a condition. |
Events
Returns what happened on one timeline: earnings, dividends, splits, filings, insider trades and analyst actions, plus opt-in estimate revisions, news and signal firings.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| GET | /v2/events/kinds | tickerbot_list_event_kinds | Returns every event kind with its fields and filters. |
| GET | /v2/events | tickerbot_query_events | Queries events with SQL, as events or rollups. |
| POST | /v2/events/subscribe | tickerbot_subscribe_events | Creates a webhook on new events: earnings, dividends, splits, filings, insider trades, analyst actions or estimate revisions. |
News
Queries article-level news with SQL, back to 2015 and refreshed every 15 minutes, as articles or rollups by ticker, day, source or sentiment.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| GET | /v2/news | tickerbot_query_news | Queries news with SQL, as articles, per-ticker mentions or rollups. |
| POST | /v2/news/subscribe | tickerbot_subscribe_news | Creates a webhook that fires on each new article matching your filters. |
Universes
Saves named ticker lists that scope any screen.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| GET | /v2/universes | tickerbot_list_universes | Lists universes: yours, the built-in ones or both. |
| GET | /v2/universes/{universe} | tickerbot_get_universe | Returns one universe: a built-in or one of yours. |
| POST | /v2/universes | tickerbot_create_universe | Saves a named list of tickers to scope screens and subscriptions. |
| PATCH | /v2/universes/{universe} | tickerbot_update_universe | Updates one of your universes. |
| DELETE | /v2/universes/{universe} | tickerbot_delete_universe | Deletes one of your universes. |
Webhooks
Manages your subscriptions: each pairs a screen, a signal, a ticker, an event feed or a news feed with a delivery we push when it fires. Create them with the subscribe call on Scan, Signals, Tickers, Events or News.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| GET | /v2/webhooks | tickerbot_list_webhooks | Lists every webhook on your account. |
| GET | /v2/webhooks/{webhook} | tickerbot_get_webhook | Returns one webhook. |
| PATCH | /v2/webhooks/{webhook} | tickerbot_update_webhook | Edits a webhook in place: its trigger, delivery, name or state. |
| DELETE | /v2/webhooks/{webhook} | tickerbot_delete_webhook | Deletes a webhook. |
| POST | /v2/webhooks/{webhook}/test | tickerbot_test_webhook | Sends a sample delivery to your endpoint, instantly. |
| GET | /v2/webhooks/{webhook}/deliveries | tickerbot_list_webhook_deliveries | Lists a webhook's recent deliveries. |
| POST | /v2/webhooks/{webhook}/deliveries/{delivery}/redeliver | tickerbot_redeliver_webhook_delivery | Resends a past delivery to your endpoint. |
Websockets
Streams each ticker's latest values over a held-open websocket as they update.
| Method | Path | MCP tool | Summary |
|---|---|---|---|
| WSS | /v2/stream | Streams each ticker's latest values over a held-open websocket as they update. | |
| GET | /v2/stream/usage | Reports your current streaming usage against your account's cap. |