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

/api/v1/funding_rate/history?symbol=BTC

Response

  • Status 200: Successfully retrieved funding history

{
  "success": true,
  "data": [ // Returns historical funding rates for the past 50 hours
    {
      "oracle_price": "117170.410304",
      "bid_impact_price": "117126",
      "ask_impact_price": "117142",
      "funding_rate": "0.0000125",
      "next_funding_rate": "0.0000125",
      "created_at": 1753806934249 // one record per 15 minute interval
    },
    ... // Total of 200 records max
  ]
}
    
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()

Last updated