Documentation / API reference / Price
Get Price OHLC
Reference
Last reviewed 2026-09-18
Returns open, high, low and close price candles for an asset and period, with timestamps and volume. Use the time-range filters to select the reporting window.
Try it
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
asset | query | string | Yes | |
period | query | string | Yes | One hour, one day or one month. One of 1m, 1h, 1d. |
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, |
Responses
200 — Price OHLCs retrieved successfully
| Field | Type | Required |
|---|---|---|
data | array | Yes |
data[].asset | string | Yes |
data[].close | string | Yes |
data[].high | string | Yes |
data[].low | string | Yes |
data[].open | string | Yes |
data[].period | string | Yes |
data[].timestamp | 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": [
{
"asset": "TAO",
"close": "366.4996",
"high": "385.8701",
"low": "363.6157",
"open": "379.5458",
"period": "1d",
"timestamp": "2025-02-26T00:00:00Z",
"volume_24h": "263821126.1415"
},
{
"asset": "TAO",
"close": "381.5133",
"high": "405.8875",
"low": "356.3167",
"open": "397.1862",
"period": "1d",
"timestamp": "2025-02-25T00:00:00Z",
"volume_24h": "417313992.0036"
}
],
"pagination": {
"current_page": 1,
"next_page": 2,
"per_page": 50,
"prev_page": null,
"total_items": 977,
"total_pages": 20
}
}Response details
text
{
"period": "1d" time period selected,
"timestamp": "2025-04-28T00:00:00Z",
"asset": "TAO",
"volume_24h": "193875141.3324"volume in USD,
"open": "361.6671" open price,
"high": "388.2342" high price,
"low": "346.4353"low price,
"close": "361.9194" close price
},Other responses
| Status | Meaning |
|---|---|
400 | Bad request |
404 | Price OHLCs not found |
500 | Internal server error |
Every request needs an Authorization header holding your API key — see Getting started with the Taostats API.