v1

latestOpenAPI 3.1.02026-07-2681217214.1 KB

Get funding rates

Hourly funding rate timeseries for a perpetual market. Query window capped at 7 days per request.

get/api/v1/markets/{market_id}/perps/funding

Path parameters

market_idstring required

Canonical market slug, {venue}:{instrument_type}:{pair}.

Query parameters

start_timestampstring required

Start of the window (ISO 8601; naive datetimes treated as UTC).

end_timestampstring required

End of the window (ISO 8601).

limitinteger

Maximum rows to return (1–5000).

Response

Funding samples, one per hour.

Example response

{
  "items": [
    {
      "market_id": "hl:perp:BTC-USDC",
      "ts": "2026-05-01T00:00:00.000000+00:00",
      "funding_rate": "0.0000125",
      "premium_index": "0.0000098",
      "interval_seconds": 3600
    }
  ]
}