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
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.
asset_id?stringBackend asset ID. Mutually exclusive with symbol: exactly one of
the two is required, and naming both is a 400.
uuidsymbol?stringDeprecatedPerp symbol to fetch the snapshot series for (e.g. BTC).
window?stringLookback period (e.g. 1h, 4h, 1d, 7d, 1M).
"1h"resolution?stringBucket size (e.g. 5m, 1h, 1d). Must be at least 1h for windows over 1d.
"5s"Funding rate and open interest series for the requested perp
application/json- response
asset_id?stringBackend asset ID of the perp
uuidsymbol?stringThe perp symbol
window?stringThe time window used for the query
resolution?stringThe time resolution used for the query
points?array<>Funding rate and open interest buckets, oldest first
curl -X GET 'https://api.truemarkets.co/v1/defi/market/market-data/perp/history'{ "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" } ]}Get reported market-cap history GET
Returns an asset's reported market capitalisation in USD over a configurable lookback window, sampled at a configurable resolution.
Get reported 24h volume history GET
Returns an asset's reported 24h volume in USD over a configurable lookback window, sampled at a configurable resolution.