---
title: "Get perp funding rate and open interest history"
url: https://docs.truemarkets.co/api/market-data/get-perp-market-history
description: "Returns a perpetual future's funding rate and open interest over a configurable lookback window, sampled at a configurable resolution. Both series come from the same venue snapshot row, so a caller reading them together never compares values sampled at different times."
---

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

# Get perp funding rate and open interest history

Returns a perpetual future's funding rate and open interest over a
configurable lookback window, sampled at a configurable resolution.
Both series come from the same venue snapshot row, so a caller reading
them together never compares values sampled at different times.

`funding_rate` is the venue's hourly rate as a decimal fraction, so
`0.0000125` is 0.00125% per hour. `open_interest` is a coin count of the
base asset (`35984.2` for BTC), not a USD notional.

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/perp/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 | Perp symbol to fetch the snapshot series for (e.g. `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

Funding rate and open interest series for the requested perp

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `asset_id` | string (uuid) | no | Backend asset ID of the perp |
| `symbol` | string | no | The perp 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 | Funding rate and open interest buckets, oldest first |
| `points[].t` | string (date-time) | no | ISO 8601 timestamp of the bucket |
| `points[].funding_rate` | string | no | Hourly funding rate as a decimal fraction (0.0000125 is 0.00125% per hour) |
| `points[].open_interest` | string | no | Open interest as a coin count of the base asset, not a USD notional |

### 400

Bad request - invalid parameters

### 404

Unknown perp, or no snapshot in the window

### 500

Internal server error
