How credits work
Each plan gives you credits for each period. A call uses credits according to how much data it returns.
The rule
Items are the rows or points a call returned.
credits = max(min_credits, ceil(items / 100)) * multiplier- The multiplier is 1 on every endpoint today.
- A result with no items costs nothing, on every endpoint.
- Only HTTP 200 is charged. Errors, including rate limits, are free.
Examples
| Call | Credits |
|---|---|
| One asset, or any other fixed-price endpoint | 1 |
| A list that returns 100 rows | 1 |
| A list that returns 101 rows | 2 |
| A chart that returns 1,000 points | 10 |
| A list that returns nothing | 0 |
| Any error | 0 |
| Checking your key with /v1/key/info | 0 |
Your balance
- All keys on an account share one balance. Rate limits apply per key.
- The balance renews at the start of each period. Unused plan credits do not carry over.
- Top-up credits do not expire. They are added to your balance.
- A call that is running as your balance reaches zero can take it slightly negative. The next call is refused.
History depth
Your plan sets how far back you can ask. A window older than that returns error 1007. Data is never silently cut short.