> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Get Token Supply History > [OpenAPI JSON Spec](/docs/output/v1_crypto_supply_get.json) **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 `interval` parameter 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 ## OpenAPI ````yaml /api-reference/openapi.json get /v1/crypto/supply openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/crypto/supply: get: tags: - Crypto summary: Get Token Supply History description: > [OpenAPI JSON Spec](/docs/output/v1_crypto_supply_get.json) **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 `interval` parameter 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 parameters: - description: Token symbol (e.g., BTC, ETH) in: query name: symbol required: true schema: type: string - description: Start timestamp (Unix seconds), must be greater than 0 in: query name: start_time required: true schema: type: integer format: int64 - description: End timestamp (Unix seconds), must be greater than 0 in: query name: end_time required: true schema: type: integer format: int64 - description: Data interval - day-level or above only (e.g., 1d, 7d, 30d) in: query name: interval schema: type: string responses: '200': description: Successfully retrieved supply history content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.TokenSupplyItem' type: array type: object '400': description: Invalid parameters content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.TokenSupplyItem: properties: circulating_supply: type: number name: type: string symbol: type: string time: description: Formatted time (YYYY-MM-DD hh:mm:ss, UTC+0) type: string timestamp: type: integer total_supply: type: number type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ````