ASasksurf
Exchange

Exchange Funding Rate History

Returns historical funding rate records for a perpetual contract.

Pagination: use from to set the start time and limit to control result count. For longer history, pass the last returned timestamp as the next from value.

Note: not all exchanges support historical queries via from; some only return recent data regardless.

For the latest funding rate snapshot, see /exchange/perp?fields=funding.

get/gateway/v1/exchange/funding-history

Request

  • Base URL
    https://api.asksurf.ai
  • Auth
    HTTP bearer

Query parameters

pairstring required

Trading pair (e.g. BTC/USDT)

Example:BTC/USDT
fromstring

Start of time range. Accepts Unix seconds or date string (YYYY-MM-DD, ISO8601). Not all exchanges support historical queries; some only return recent data regardless of this value.

Example:2026-03-01
limitinteger

Max number of records. For longer history, paginate using the last returned timestamp as the next from value.

Example:100
exchange'binance' | 'okx' | 'bybit' | 'bitget' | 'gate' | 'htx' | 'mexc' | 'bitfinex' | 'bitmex' | 'hyperliquid'

Exchange identifier. Note: hyperliquid uses USDC-settled perps (e.g. BTC/USDC:USDC); pass USDC-quoted pairs when querying hyperliquid.

Example:binance

Response

OK

$schemastring uri

A URL to the JSON Schema for this object.

Example response

{
  "$schema": "https://example.com/schemas/SimpleListResponseExchangeFundingHistoryItem.json"
}

Changes

No recorded changes to this operation across all 12 revisions of this API.