Support

Frequently asked questions

Getting started

How do I get an API key?
Create an account at tickerbot.io/dashboard and mint your first key from the dashboard. You start on the free plan; upgrade when you want webhooks, websocket streaming, or higher rate limits. You can also try the API without an account from the docs. The “Try it” panel on each endpoint page is rate-limited by IP.

What endpoints are there?
Eleven families: /v2/tickers, /v2/signals, /v2/scan, /v2/series, /v2/bars, /v2/events, /v2/news, /v2/etf, /v2/universes, /v2/webhooks, and /v2/stream. See the endpoints reference.

How do I authenticate?
Bearer token in the Authorization header. See /docs/authentication.

Plans & billing

How are paid plans billed?
Stripe — monthly or annual (20% off annual). Upgrade to a paid tier from your dashboard; billing starts immediately on upgrade. Cancel any time to drop back to the free plan. Manage the subscription from your dashboard (cancel anytime). Full pricing on the pricing page.

What happens if I cancel or my card fails?
At the end of the paid period your account drops to the free plan — API keys keep working at free limits (60 req/min, no webhooks and no websocket streaming). Webhooks are disabled; universes and custom columns are preserved. Resubscribe to re-enable webhooks. We don’t delete data.

Do you offer custom / enterprise plans?
Yes. Higher rate limits, dedicated infrastructure, custom SLAs, and direct support. Use the contact form below.

Data & coverage

What’s in the universe?
Every US stock and ETF (~23,284), refreshed every minute during market hours (crypto runs 24/7), plus the US Treasury curve, major FX pairs and spot metals, and the major crypto pairs. Stocks and ETFs carry the full schema — every column. The non-equity series carry price and OHLCV history; see tickers for what applies to each class.

How far back does history go?
All-time on every plan, Free included, historized back to 2003 and to each ticker’s first day in our coverage. Pin ?asof= on any read endpoint — /v2/tickers, /v2/signals, or /v2/scan — for the state as it stood that day. The news + sentiment archive (back to 2015) is available on every plan.

How fresh is the data?
Recomputed every minute during US market hours and 24/7 for cryptos — same on every plan. Webhooks fire in real-time (the moment each refresh lands) on every paid plan; you can optionally throttle a webhook to hourly or at market open.

Webhooks

How are deliveries signed?
Each request includes an X-Tickerbot-Signature header (HMAC SHA-256 of the body, keyed on the subscription’s signing secret). The secret is shown once on creation.

What happens on a 5xx from my endpoint?
We retry with exponential backoff for ~24 hours. Persistent failures auto-disable the subscription — GET /v2/webhooks reflects the disabled state.

Reliability

Is there an uptime page?
Not yet: the status page is being rebuilt. Follow @tickerbotio for incidents.

Do you offer SLAs?
Not on Hobby / Pro / Scale. SLAs are part of every Enterprise contract.