Get historical funding

This endpoint retrieves the historical funding for a particular symbol

GET /api/v1/funding_rate/history

Query Parameters

Field	Type	Need	Description	Example
"symbol"	string	required	Market symbol to query	BTC
"limit"	integer	optional	Number of records to show (default 200, max 4000)	200
"offset"	integer	optional	Pagination to access older records. Default to 0	0

/api/v1/funding_rate/history?symbol=BTC&limit=200&offset=0

Response

• Status 200: Successfully retrieved funding history

{
  "success": true,
  "data": [ 
    {
      "oracle_price": "117170.410304",
      "bid_impact_price": "117126",
      "ask_impact_price": "117142",
      "funding_rate": "0.0000125",
      "next_funding_rate": "0.0000125",
      "created_at": 1753806934249
    },
    ... 
  ]
}
    

Field	Type	Description
'oracle_price'	decimal string	Oracle price used for funding rate calculation
'bid_impact_price'	decimal string	Bid impact price at time of calculation (see funding rate docs)
'ask_impact_price'	decimal string	Ask impact price at time of calculation (see funding rate docs)
'funding_rate'	decimal string	Last settled funding rate
'next_funding_rate'	decimal string	Predicted funding rate for next settlement
'created_at'	integer	Timestamp in milliseconds

• Status 400: Invalid request parameters

• Status 401: Unauthorized access

• Status 500: Internal server error

Code Example (Python)

import requests

response = requests.get(
    "/api/v1/funding_rate/history?symbol=BTC,"
    headers={"Accept": "*/*"},
)

data = response.json()