Skip to main content
GET
/
gateway
/
v1
/
exchange
/
funding-history
Exchange Funding Rate History
curl --request GET \
  --url https://api.asksurf.ai/gateway/v1/exchange/funding-history
{
  "data": [
    {
      "exchange": "<string>",
      "funding_rate": 123,
      "pair": "<string>",
      "timestamp": 123
    }
  ],
  "meta": {
    "cached": true,
    "credits_used": 123
  },
  "$schema": "<string>"
}

Documentation Index

Fetch the complete documentation index at: https://docs.asksurf.ai/llms.txt

Use this file to discover all available pages before exploring further.

Query Parameters

​
pair
string
required

Trading pair (e.g. BTC/USDT)

Example:

"BTC/USDT"

​
from
string

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"

​
limit
integer<int64>
default:100

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

Required range: 1 <= x <= 500
Example:

100

​
exchange
enum<string>
default:binance

Exchange identifier

Available options:
binance,
okx,
bybit,
bitget,
gate,
htx,
mexc,
bitfinex,
bitmex
Example:

"binance"

Response

OK

​
data
object[] | null
required
​
meta
object
required
​
$schema
string<uri>
read-only

A URL to the JSON Schema for this object.

Example:

"https://example.com/schemas/SimpleListResponseExchangeFundingHistoryItem.json"