Rate Limits
Credit limits, counting rules, and response headers
Limits by Tier
| Tier | Included Monthly Credits |
|---|---|
| Starter | 1,000 credits |
| Plus (Individual) | 100,000 credits |
| Pro (Individual) | 1,000,000 credits |
| Business | 1,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/:tickerreturning404(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
429when 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:
| Header | Type | Description |
|---|---|---|
X-Request-Limit | integer | Included monthly credits for your tier |
X-Requests-Used | integer | Credits used this month |
X-Requests-Remaining | integer | Included credits remaining this month. This is 0 after the included amount is exceeded. |
X-Request-Reset | string | UTC 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"
}