Get Token Supply History
Crypto
Get Token Supply History
OpenAPI JSON Spec Feature Overview
Get historical supply data (circulating and total supply) for a specific cryptocurrency token. This endpoint returns time series data showing how the token’s supply has changed over time.
Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Token symbol (e.g., BTC, ETH) |
| start_time | int64 | Yes | Start timestamp (Unix seconds), must be > 0 |
| end_time | int64 | Yes | End timestamp (Unix seconds), must be > 0 |
| interval | string | No | Data interval - day-level or above only (e.g., 1d, 2d, 7d, 14d, 30d, 60d, 90d, 365d) |
Important Notes
- The
intervalparameter only supports day-level or above aggregation - Supported intervals: 1d, 2d, 3d, 7d, 14d, 15d, 30d, 60d, 90d, 365d, etc.
- Hour-level intervals (e.g., 1h, 2h, 12h) are NOT supported
Response Data
Returns an array of supply data points, each containing:
- symbol: Token symbol
- name: Token name
- timestamp: Unix timestamp (seconds)
- date: Human-readable date (YYYY-MM-DD HH:mm:ss, UTC+0)
- circulatingSupply: Current circulating supply
- totalSupply: Total supply
GET
Get Token Supply History
Authorizations
API Key authentication. Example: "your-api-key-here"
Query Parameters
Token symbol (e.g., BTC, ETH)
Start timestamp (Unix seconds), must be greater than 0
End timestamp (Unix seconds), must be greater than 0
Data interval - day-level or above only (e.g., 1d, 7d, 30d)

