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 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 and capped at 50 rows.

What endpoints are there?
Seven families: /v2/tickers, /v2/signals, /v2/scan, /v2/webhooks, /v2/universes, /v2/analyst, and /v2/news. 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). Webhooks are disabled and universes 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?
All US equities (~12,947) 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?
All-time on every plan, Free included, back to each ticker’s first day in our coverage. Pin ?asof= on any read endpoint — /v2/tickers, /v2/signals, or /v2/scan — to replay 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?
Yes — tickerbot.io/status shows the live state of every public endpoint.

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