---
title: "Get price history for an asset"
url: https://docs.truemarkets.co/api/market-data/get-asset-price-history
description: "Returns historical price points for an asset over a configurable lookback"
---

Docs index: https://docs.truemarkets.co/llms.txt

# Get price history for an asset

```
GET https://api.truemarkets.co/v1/assets/prices/history
```

Returns historical price points for an asset over a configurable lookback
window, sampled at a configurable resolution.

The same series as `/v1/defi/market/prices/history`, mounted under the
asset-oriented path. This mount stores no individual ticks, so candle
endpoints and candle-input indicators are unavailable here.

See the [Time Window & Resolution](#section/Time-Window-and-Resolution)
section for the format of `window` and `resolution`.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `asset_id` | query | string (uuid) | no | Backend asset ID. Mutually exclusive with `symbol`: exactly one of the two is required, and naming both is a 400. |
| `symbol` | query | string | no | Asset symbol (e.g. `SOL`, `BTC`). |
| `window` | query | string | no | Lookback period (e.g. `1h`, `4h`, `1d`, `7d`, `1M`). |
| `resolution` | query | string | no | Gap between consecutive data points (e.g. `5s`, `1m`, `5m`, `1h`). |
| `asset_class` | query | string, one of `spot`, `perp` | no | Asset class to resolve the asset in. Defaults to `spot`. |

## Responses

Every error status returns the same body, described in [Errors](https://docs.truemarkets.co/developer-resources/errors.md).

### 200

Price history data for the requested asset

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `asset_id` | string (uuid) | no | Backend asset ID. Absent on the CeFi routes. |
| `symbol` | string | no | The asset symbol |
| `window` | string | no | The time window used for the query |
| `resolution` | string | no | The time resolution used for the query |
| `points` | array of object | no | List of price points |
| `points[].t` | string | no | ISO 8601 timestamp for the price point |
| `points[].price` | string | no | Price at this timestamp |

### 400

Bad request - invalid parameters

### 404

Asset not found

### 500

Internal server error