# Get Price History Returns historical market quotes for an asset, including price, volume, market cap and supply. _Source: https://beta.taostats.io/docs/api-reference/price/get-price-history_ _Last reviewed: 2026-09-18_ ```http GET https://api.taostats.io/api/price/history/v1 ``` Requires an API key in the `Authorization` header. Returns historical market quotes for an asset, including price, volume, market cap and supply. Use the `asset` parameter to select the token symbol. ## Try it Try this request in the browser on the HTML version of this page, or use the code samples below. ### Examples Get the historical TAO price series ```text https://api.taostats.io/api/price/history/v1?asset=tao&limit=100 ``` ### Code samples **cURL** ```bash curl -H "Authorization: " \ "https://api.taostats.io/api/price/history/v1?asset=tao&limit=100" ``` **JavaScript** ```js const response = await fetch('https://api.taostats.io/api/price/history/v1?asset=tao&limit=100', { headers: { Authorization: '', }, }); const data = await response.json(); ``` **Python** ```python import requests response = requests.get( "https://api.taostats.io/api/price/history/v1?asset=tao&limit=100", headers={"Authorization": ""}, ) data = response.json() ``` ## Parameters | Name | In | Type | Required | Description | | --- | --- | --- | --- | --- | | `asset` | query | `string` | Yes | default value TAO | | `timestamp_start` | query | `integer (int64)` | | Start of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | | `timestamp_end` | query | `integer (int64)` | | End of timestamp range in Unix timestamp (seconds since 1970-01-01) (inclusive) | | `page` | query | `integer (int32)` | | The page number of the response. | | `limit` | query | `integer (int32)` | | The number of responses. max is 200, | | `order` | query | `string` | | Order of the responses. One of `timestamp_asc`, `timestamp_desc`. | ## Responses ### `200` — Prices retrieved successfully | Field | Type | Required | | --- | --- | --- | | `data` | `array` | Yes | | `data[].circulating_supply` | `string` | Yes | | `data[].created_at` | `string (date-time)` | Yes | | `data[].fully_diluted_market_cap` | `string` | Yes | | `data[].last_updated` | `string (date-time)` | Yes | | `data[].market_cap` | `string` | Yes | | `data[].market_cap_dominance` | `string` | Yes | | `data[].max_supply` | `string` | Yes | | `data[].name` | `string` | Yes | | `data[].percent_change_1h` | `string` | Yes | | `data[].percent_change_24h` | `string` | Yes | | `data[].percent_change_30d` | `string` | Yes | | `data[].percent_change_60d` | `string` | Yes | | `data[].percent_change_7d` | `string` | Yes | | `data[].percent_change_90d` | `string` | Yes | | `data[].price` | `string` | Yes | | `data[].slug` | `string` | Yes | | `data[].symbol` | `string` | Yes | | `data[].total_supply` | `string` | Yes | | `data[].updated_at` | `string (date-time)` | Yes | | `data[].volume_24h` | `string` | Yes | | `pagination` | `object` | Yes | | `pagination.current_page` | `integer (int32)` | Yes | | `pagination.next_page` | `integer (int32), nullable` | | | `pagination.per_page` | `integer (int32)` | Yes | | `pagination.prev_page` | `integer (int32), nullable` | | | `pagination.total_items` | `integer (int32)` | Yes | | `pagination.total_pages` | `integer (int32)` | Yes | **Example response** ```json { "data": [ { "circulating_supply": "8398025", "created_at": "2025-02-26T13:45:02Z", "fully_diluted_market_cap": "7696492573.17", "last_updated": "2025-02-26T13:44:00Z", "market_cap": "3077873192.46484", "market_cap_dominance": "0.1074", "max_supply": "21000000", "name": "Bittensor", "percent_change_1h": "-0.88079436", "percent_change_24h": "-0.250314", "percent_change_30d": "-14.498297", "percent_change_60d": "-21.61015966", "percent_change_7d": "-11.00275914", "percent_change_90d": "-34.25472829", "price": "366.499646341234", "slug": "bittensor", "symbol": "TAO", "total_supply": "8398025", "updated_at": "2025-02-26T13:45:02Z", "volume_24h": "263821126.141511" }, { "circulating_supply": "8398025", "created_at": "2025-02-26T13:30:08Z", "fully_diluted_market_cap": "7648678782.97", "last_updated": "2025-02-26T13:29:00Z", "market_cap": "3058752173.15901", "market_cap_dominance": "0.1058", "max_supply": "21000000", "name": "Bittensor", "percent_change_1h": "-1.5499066", "percent_change_24h": "-1.00469879", "percent_change_30d": "-13.90519408", "percent_change_60d": "-21.91834275", "percent_change_7d": "-10.56173525", "percent_change_90d": "-34.92053902", "price": "364.222799188977", "slug": "bittensor", "symbol": "TAO", "total_supply": "8398025", "updated_at": "2025-02-26T13:30:08Z", "volume_24h": "264387719.925533" } ], "pagination": { "current_page": 1, "next_page": 2, "per_page": 50, "prev_page": null, "total_items": 30152, "total_pages": 604 } } ``` **Response details** ```text { "created_at": "2025-04-28T15:45:04Z", "updated_at": "2025-04-28T15:45:04Z", "name": "Bittensor", "symbol": "TAO", "slug": "bittensor", "circulating_supply":"8687103" amount of token in circulation, "max_supply": "21000000" the max number of tokens, "total_supply": "8687103" , "last_updated": "2025-04-28T15:44:00Z", "price": "361.919486420088" price in USD, "volume_24h": "193875141.332405" Volume in USD, "market_cap": "3144031856.2384" Market cap in USD, "percent_change_1h": "-3.72273857" hourly price delta %, "percent_change_24h": "3.02800653" daily price delta %, "percent_change_7d": "14.53687118" weekly price delta %, "percent_change_30d": "60.5253009" monthly price delta %, "percent_change_60d": "3.36943051" 2 month price delta %, "percent_change_90d": "-20.46854563" quarterly price delta %, "market_cap_dominance": "0.1071", "fully_diluted_market_cap": "7600309214.82" market cap with todays price and full issuance }, ``` ### Other responses | Status | Meaning | | --- | --- | | `400` | Bad request | | `404` | Prices not found | | `500` | Internal server error | Every request needs an `Authorization` header holding your API key — see [Getting started with the Taostats API](https://beta.taostats.io/docs/start-here/getting-started-with-taostats-api).