Funding rate history

{
  "success": true,
  "data": {
    "rows": [
      {
        "funding_rate": "0.0001",
        "mark_price": "45678.90",
        "funding_rate_timestamp": 1716192000000
      }
    ],
    "next_cursor": null
  },
  "ts": 1779269143700
}

Historical funding rates for a symbol. Rows are written at 8-hour epoch boundaries (00:00 / 08:00 / 16:00 UTC). Weight: 2

Request

{
  "type": "fundingRateHistory",
  "symbol": "PERP_BTC_USDC",
  "start_time": 1716100000000,
  "limit": 500
}

Field	Type	Required	Default	Notes
`symbol`	string	Yes	—	Trading pair
`start_time`	int64	No	—	ms epoch
`end_time`	int64	No	—	ms epoch
`limit`	int	No	500	1..5000
`cursor`	string	No	—	Opaque cursor

Response

Field	Type	Notes
`funding_rate`	string	Per-8h cycle decimal
`mark_price`	string	Mark price snapped to the funding epoch
`funding_rate_timestamp`	int64	Funding epoch (ms epoch UTC)

Notes

30s cache

{
  "success": true,
  "data": {
    "rows": [
      {
        "funding_rate": "0.0001",
        "mark_price": "45678.90",
        "funding_rate_timestamp": 1716192000000
      }
    ],
    "next_cursor": null
  },
  "ts": 1779269143700
}

Funding comparison Liquidations

Builder quickstart

Partner onboarding & support

Core integration flows

Builders Marketplace

API fundamentals

Public Info API

General API

User API

Trading API

Strategy vault API

Staking & VALOR API

Builder API

Points module

Market data API

Websocket API

Funding rate history

Request

Response

Notes

​Request

​Response

​Notes

Request

Response

Notes