Historical funding rates

GET 
/v4/historicalfundingrates

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

OK

application/json

Schema

Schema

oneOf

Success Response

rates object[]

A list containing structures with historical funding rate information. The list is sorted ascending by timestamp.

Array [

fundingRate number

The absolute funding rate for the listed time period

relativeFundingRate number

The relative funding rate for the listed time period

timestamp date-time

The date and time UTC of the one-hour period to which the funding rate applies.

]

result stringrequired

Possible values: [success]

serverTime date-timerequired

Server time in Coordinated Universal Time (UTC)

ErrorResponse

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)

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)

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
    }
  ]
}

Loading...