For AI agents: the documentation index is at /llms.txt, and this page is available as Markdown at /api/market-data/get-perp-market-history.md.

Get perp funding rate and open interest history

GET
/v1/defi/market/market-data/perp/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 section for the format of window and resolution.

Query Parameters

asset_id?string

Backend asset ID. Mutually exclusive with symbol: exactly one of the two is required, and naming both is a 400.

Formatuuid
symbol?stringDeprecated

Perp symbol to fetch the snapshot series for (e.g. BTC).

window?string

Lookback period (e.g. 1h, 4h, 1d, 7d, 1M).

Default"1h"
resolution?string

Bucket size (e.g. 5m, 1h, 1d). Must be at least 1h for windows over 1d.

Default"5s"

Response Body

Funding rate and open interest series for the requested perp

application/json
  1. response
asset_id?string

Backend asset ID of the perp

Formatuuid
symbol?string

The perp symbol

window?string

The time window used for the query

resolution?string

The time resolution used for the query

points?array<>

Funding rate and open interest buckets, oldest first

Example Request
curl -X GET 'https://api.truemarkets.co/v1/defi/market/market-data/perp/history'
Example Response
{  "asset_id": "b4695157-0d1d-4da0-8f9e-5c53149389e4",  "symbol": "string",  "window": "string",  "resolution": "string",  "points": [    {      "t": "2019-08-24T14:15:22Z",      "funding_rate": "string",      "open_interest": "string"    }  ]}