Developer Portal
Trader APIsHTTP APIPerps

Funding Rates HistoryGET

Returns raw historical funding rates for a perpetual symbol. If `to` is omitted, defaults to the current UTC time.

View as Markdown
GET
/accounts/{account_id}/funding-rates/{symbol_id}/history

Authorization

AuthorizationRequiredBearer <token>

JWT token obtained from the login endpoint

In: header

Path Parameters

account_idRequiredstring

Account ID

symbol_idRequiredstring

Internal symbol ID

Query Parameters

tointeger

End timestamp (Unix seconds, UTC). Defaults to now.

Format: "int64"
countinteger

Maximum number of records to return

Default: 20Format: "int64"
curl -X GET "http://localhost:8081/api/v1/accounts/<string>/funding-rates/<string>/history?to=0&count=20" \
  -H "Authorization: Bearer <token>"

Funding rate history

{
  "items": [
    {
      "t": 0,
      "raw": 0.1,
      "price": 0.1,
      "settlement_period_end": "2019-08-24T14:15:22Z",
      "fetched_at": "2019-08-24T14:15:22Z",
      "applied_at": "2019-08-24T14:15:22Z"
    }
  ]
}

List Positions

Returns one page of closed-position history for the authenticated user, newest creation time first. There is no maximum date range. When more positions match, the response carries `next_token`; pass it back to fetch the next page. An absent `next_token` means this is the last page.

Funding Rates

Returns the live funding rate and next settlement time for a perpetual symbol, using the rates that apply to the authenticated user. Returns 404 if the symbol has no active funding rate, or if funding rates are not configured for this user.