Funding History

The endpoint returns the funding rate payment history for collateral positions. Each record includes the funding rate, settlement price, position amount, and the resulting funding payment. Use the optional market parameter to filter results to a single trading pair. The response supports pagination via limit and offset parameters. Results are ordered by funding time (fundingTime), newest first.

<Warning> Rate limit: 12000 requests/10 sec. </Warning> <Note> This endpoint supports pagination. Use `limit` (default: 100) and `offset` (default: 0) to page through results. The response does not include a `total` field — detect the last page when `records.length < limit`. An empty `records` array means you have paged past the end; receiving exactly `limit` records does not guarantee that another page exists. </Note> <Accordion title="Error Codes"> - `30` - default validation error code (invalid pagination — `limit` outside 1–100 or negative `offset`) - `31` - market validation failed (the `market` filter is unknown or not available for collateral trading) </Accordion>

{
  "market": "BTC_PERP",
  "limit": 100,
  "request": "{{request}}",
  "nonce": 1594297865000
}

{
  "records": [
    {
      "market": "BTC_PERP",
      "fundingTime": "1734451200",
      "fundingRate": "0.00017674",
      "fundingAmount": "-0.171053531892",
      "positionAmount": "0.019",
      "settlementPrice": "50938.2",
      "rateCalculatedTime": "1734364800"
    }
  ],
  "limit": 100
}