Historical funding rates

GET 
/historical-funding-rates

Returns list of historical funding rates for given market.

Request

Query Parameters

symbol MarketSymbolrequired

Possible values: Value must match regular expression [A-Z0-9_.]+

Market symbol.

Responses

200

Historical funding rates for given market.

application/json

Schema

Schema

rates object[]required
A list containing structures with historical funding rate information. The list is sorted ascending by timestamp.
Array [
fundingRate doublerequired
The absolute funding rate for the listed time period
relativeFundingRate doublerequired
The relative funding rate for the listed time period
timestamp date-timerequired
Start of the period to which the funding rate applies.
]
result stringrequired

Possible values: [success]

serverTime date-timerequired

Server time in Coordinated Universal Time (UTC)

Example (from schema)

{
  "rates": [
    {
      "fundingRate": 12.03532,
      "relativeFundingRate": 12.03532,
      "timestamp": "2024-07-29T15:51:28.071Z"
    }
  ],
  "result": "success",
  "serverTime": "2020-08-27T17:03:33.196Z"
}

success

{
  "result": "success",
  "serverTime": "2022-06-28T09:29:04.243Z",
  "rates": [
    {
      "timestamp": "2022-06-28T00:00:00.000Z",
      "fundingRate": -8.15861558e-10,
      "relativeFundingRate": -0.000016898883333333
    },
    {
      "timestamp": "2022-06-28T04:00:00.000Z",
      "fundingRate": -2.6115278e-11,
      "relativeFundingRate": -5.40935416667e-7
    },
    {
      "timestamp": "2022-06-28T08:00:00.000Z",
      "fundingRate": -4.08356853e-10,
      "relativeFundingRate": -0.000008521190625
    }
  ]
}

400

Symbol is invalid or does not reference a perpetual market.

application/json

Schema

Schema

errors Error (string)[]

Possible values: [accountInactive, apiLimitExceeded, authenticationError, insufficientFunds, invalidAccount, invalidAmount, invalidArgument, invalidUnit, Json Parse Error, marketUnavailable, nonceBelowThreshold, nonceDuplicate, notFound, requiredArgumentMissing, Server Error, Unavailable, unknownError]

error Error (string)required
Possible values: [accountInactive, apiLimitExceeded, authenticationError, insufficientFunds, invalidAccount, invalidAmount, invalidArgument, invalidUnit, Json Parse Error, marketUnavailable, nonceBelowThreshold, nonceDuplicate, notFound, requiredArgumentMissing, Server Error, Unavailable, unknownError]
Error description.
• accountInactive: The Futures account the request refers to is inactive
• apiLimitExceeded: The API limit for the calling IP address has been exceeded
• authenticationError: The request could not be authenticated
• insufficientFunds: The amount requested for transfer is below the amount of funds available
• invalidAccount: The Futures account the transfer request refers to is invalid
• invalidAmount: The amount the transfer request refers to is invalid
• invalidArgument: One or more arguments provided are invalid
• invalidUnit: The unit the transfer request refers to is invalid
• Json Parse Error: The request failed to pass valid JSON as an argument
• marketUnavailable: The market is currently unavailable
• nonceBelowThreshold: The provided nonce is below the threshold
• nonceDuplicate: The provided nonce is a duplicate as it has been used in a previous request
• notFound: The requested information could not be found
• requiredArgumentMissing: One or more required arguments are missing
• Server Error: There was an error processing the request
• Unavailable: The endpoint being called is unavailable
• unknownError: An unknown error has occurred
result stringrequired

Possible values: [error]

serverTime date-timerequired

Server time in Coordinated Universal Time (UTC)

Example (from schema)

{
  "errors": [
    "accountInactive"
  ],
  "error": "accountInactive",
  "result": "error",
  "serverTime": "2020-08-27T17:03:33.196Z"
}

Loading...