Support

Frequently asked questions

Getting started

How do I get an API key?
Create an account at tickerbot.io/dashboard, pick a plan to start your 14-day free trial, and create your first key from the dashboard. You can also try the API without an account on the landing page — the sandbox is rate-limited by IP and capped at 50 rows per response.

What endpoints are there?
Six families: /v2/tickers, /v2/signals, /v2/scan, /v2/universes, /v2/rules, and /v2/webhooks. See the endpoints reference.

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

Plans & billing

What does Free include?
All read endpoints (scan, signals,tickers) against the full ~12,000-ticker universe, 15 requests per minute, one year of per-ticker history. No card required. Webhooks, universes, saved rules, and historical scans (asof) start at Hobby ($29/mo).

How are paid plans billed?
Stripe — monthly, with a free trial on first sign-up. Manage the subscription from your dashboard (cancel anytime). Full pricing on the pricing page.

What happens if I cancel or my card fails?
Your account falls back to Free — you keep API access at the Free quota. We don’t revoke keys or delete data.

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

Data & coverage

What’s in the universe?
All US equities (~12,000) and the top 100 cryptocurrencies, refreshed every minute during market hours (crypto runs 24/7). Each ticker carries the full schema — see all fields and flags.

How far back does history go?
Two dimensions. Per-ticker history (/v2/signals/{signal}/{ticker}/history/{interval} and /v2/tickers/{ticker}/history?asof=) is one year on Free and Hobby, five years on Pro, all-time on Scale and Enterprise. Historical scan (/v2/scan?asof=, market-wide) is disabled on Free; one year on Hobby; five years on Pro; all-time on Scale and Enterprise. Beyond your window the response is history_window_exceeded with earliest_allowed_asof so you can clamp.

How fresh is the data?
Recomputed every minute during regular market hours. Webhook evaluation runs on a per-webhook cadence (1m, 5m, 15m, hourly, or NYSE-open) — the plan's max cadence sets the ceiling.

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?
Yes — tickerbot.io/status shows the live state of every public endpoint.

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