Rate Limits

Credit limits, counting rules, and response headers

Limits by Tier

TierIncluded Monthly Credits
Starter1,000 credits
Plus (Individual)100,000 credits
Pro (Individual)1,000,000 credits
Business1,000,000 credits per seat

Counting Rules

  • Most API calls cost 1 credit, including Search.
  • OHLCV costs 1 credit per 100 bars returned, rounded up, with a 1 credit minimum for valid requests.
  • Watchlist GET costs 1 credit per ticker, and summary event lookups with cross-asset correlation cost 2 credits.
  • /v1/summary/:ticker returning 404 (unknown ticker) does not count against limits
  • HTTP 304 (conditional/cached) responses do not count
  • Monthly usage resets at 00:00 UTC on the first day of each calendar month
  • Plus, Pro, and Business continue after the included monthly amount and additional usage is billed at $1 per 10,000 requests
  • Starter has no overage billing and returns HTTP 429 when its monthly quota is exhausted
  • Business limits are per seat. Team members do not share rate limits, watchlist capacity, or webhook URL capacity.
Monthly Usage
TickerDB uses one monthly request bucket per account. There are no hourly or daily request caps on the standard plans.

Rate Limit Headers

Every response includes these headers:

HeaderTypeDescription
X-Request-LimitintegerIncluded monthly credits for your tier
X-Requests-UsedintegerCredits used this month
X-Requests-RemainingintegerIncluded credits remaining this month. This is 0 after the included amount is exceeded.
X-Request-ResetstringUTC timestamp when the monthly bucket resets

Example Headers

X-Request-Limit: 100000 X-Requests-Used: 42 X-Requests-Remaining: 99958 X-Request-Reset: 2026-04-01T00:00:00Z

429 Response

{ "error": "rate_limit_exceeded", "message": "Monthly request limit reached.", "upgrade_url": "https://tickerdb.com/pricing", "reset": "2026-04-01T00:00:00Z" }