---
title: "Get CeFi min/max price over a window"
url: https://docs.truemarkets.co/api/market-data/get-cefi-price-range
description: "Returns the minimum and maximum bid/ask midpoint price observed for"
---

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

# Get CeFi min/max price over a window

```
GET https://api.truemarkets.co/v1/cefi/market/prices/range
```

Returns the minimum and maximum bid/ask midpoint price observed for
a CeFi instrument within a configurable lookback window, along with
the timestamps at which each extreme occurred.

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `symbol` | query | string | yes | Venue-native CeFi instrument symbol (e.g. `BTC-USD`). Required here: `asset_id` is rejected with a 400 on the CeFi routes, since CeFi instruments carry no price-source mapping to resolve one against. |
| `window` | query | string | no | Lookback period (e.g. `1h`, `4h`, `1d`, `7d`, `1M`). |

## Responses

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

### 200

Price range data for the requested CeFi symbol

| 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 |
| `min_price` | string | no | Minimum price within the window |
| `max_price` | string | no | Maximum price within the window |
| `min_timestamp` | string | no | ISO 8601 timestamp when the minimum price occurred |
| `max_timestamp` | string | no | ISO 8601 timestamp when the maximum price occurred |

### 400

Bad request - invalid parameters

### 404

No price data found for the symbol within the window

### 500

Internal server error