Get Funding History

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": [
    {
      "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

"open_long" "open_short" "close_long" "close_short"

'next_funding_rate'

decimal string

"normal" regular user-initiated trading "market_liquidation" position was liquidated due to insufficient margin "backstop_liquidation" position was liquidated by backstop mechanism "settlement" position was closed due to Auto-Deleveraging (ADL) or other 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/trades?symbol=BTC",
    headers={"Accept": "*/*"},
)

data = response.json()

Last updated

Revision created