Documentation / API reference / Price
Get Price History
Reference
Last reviewed 2026-09-18
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
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.