Skip to main content
GET
GET /perps/funding/history: Funding History
Sign each request with a fresh HMAC signature. The cURL and HTTP header values below are placeholders, not reusable credentials. For runnable signing code, use request signing examples.
Per-interval funding observations for one instrument, oldest first. Each observation carries the venue-published per-interval rate (kept as an exact decimal string), the interval it applies to and its provenance, plus the rate normalised to an hourly figure and expressed as an annualised percentage. This is analytics data, not tax-grade. Part of the Perps Data product; scope analytics.read.

Query Parameters

string
required
The instrument, by its venue-native id (for example 6) or its canonical symbol (for example BTC). Matches [A-Za-z0-9._-]{1,32}.
string
One of polymarket, binance, bybit, hyperliquid. Omit for the default. Polymarket is the covered venue; the others exist for the funding comparison.
string
Start of the window. Accepts RFC3339, unix seconds or unix milliseconds.
string
End of the window. Same formats as from. The window may span at most 31 days; a wider range is refused with 400 range_too_large.
integer
default:"1000"
Rows per page, 1–5000.

Response

Observations in data, oldest first. When has_more is true, page forward by passing next_from_ms back as from.
string
The instrument the observations are for.
integer
The funding interval requested, in minutes.
string
The basis the per-interval rate is quoted on.
array
boolean
true when more rows remain beyond this page.
integer
Present when has_more is true. Pass it back as from to read the next page.

Example