---
title: "Get reported 24h volume history"
url: https://docs.truemarkets.co/api/market-data/get-volume-history
description: "Returns an asset's reported 24h volume in USD over a configurable lookback window, sampled at a configurable resolution."
---

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

# Get reported 24h volume history

Returns an asset's reported 24h volume in USD over a configurable
lookback window, sampled at a configurable resolution.

Each point is the rolling 24h figure the data provider reported at that
timestamp, not the volume traded inside the bucket. Two adjacent points
therefore overlap by almost a full day.

See the [Time Window & Resolution](https://docs.truemarkets.co/api/market-data/market-data-service-api#time-window--resolution)
section for the format of `window` and `resolution`.

## Request

```
GET https://api.truemarkets.co/v1/defi/market/market-data/volume/history
```

### 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 to fetch reported volume for (e.g. `SOL`, `BTC`). |
| `window` | query | string | no | Lookback period (e.g. `1h`, `4h`, `1d`, `7d`, `1M`). |
| `resolution` | query | string | no | Bucket size (e.g. `5m`, `1h`, `1d`). Must be at least `1h` for windows over `1d`. |

## Responses

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

### 200

Reported 24h volume series for the requested asset

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `asset_id` | string (uuid) | no | Backend asset ID |
| `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 | Reported 24h volume buckets, oldest first |
| `points[].t` | string (date-time) | no | ISO 8601 timestamp of the bucket |
| `points[].volume` | string | no | Reported rolling 24h volume in USD at this timestamp |

### 400

Bad request - invalid parameters

### 404

Unknown asset, no reported-volume source, or no data in the window

### 500

Internal server error
