v1

latestOpenAPI 3.0.32026-07-2613529376.3 KB

Public API V4

Funding History

The endpoint returns the funding rate history for a specified futures market. Use the response to analyze historical funding rate trends and settlement prices. Results are sorted by funding time in descending order and support offset-based pagination via limit and offset parameters.

<Warning> Rate limit 2000 requests/10 sec. </Warning> <Note> This endpoint supports pagination. Use `limit` (default: 100, max: 100) and `offset` (default: 0, max: 1000000) to page through results. </Note> <Note> The response is a plain array with no `total`, `has_more`, or cursor — a returned count below `limit` marks the last page (an empty array means no further records). </Note> <Note> Funding history is served per request at the API layer, with no application-level cache. </Note>

get/api/v4/public/funding-history/{market}

Path parameters

marketstring required

Example:BTC_PERP

Market name (e.g., BTC_PERP)

Query parameters

startDateinteger

Example:1752480000

Start timestamp in seconds

endDateinteger

Example:1752537600

End timestamp in seconds

limitinteger

Example:100

Number of records to return. Default: 100, Maximum: 100

offsetinteger

Number of records to skip. Maximum: 1000000

Response

Successful response

fundingTimestring required

Unix timestamp in seconds when the funding settlement executed.

fundingRatestring required

Funding rate applied at the settlement interval. Each record represents a historical settlement event.

marketstring required

Futures market pair name (e.g., BTC_PERP).

settlementPricestring required

Mark price in the quote currency at the time of funding settlement.

rateCalculatedTimestring required

Unix timestamp in seconds when the funding rate was calculated. The rate is computed before the actual settlement.

Example response

[
  {
    "fundingTime": "1752537600",
    "fundingRate": "-0.0001229",
    "market": "BTC_PERP",
    "settlementPrice": "119816.5",
    "rateCalculatedTime": "1752508800"
  }
]