v1

latestOpenAPI 3.0.32026-07-267278168.1 KB

Funding Rate

Get Funding Fee Payments

Get a paginated history of funding fee payments for the authenticated account. For how funding is calculated and applied, see Funding rates.

get/v1/perps/funding_fees

Query parameters

marketstring

Example:AAPL-USD.P

Trading market to filter by

limitinteger

Example:1000

Maximum number of results to return

cursorstring

Example:NQ5WWO3THN3Q====

Pagination cursor

startTimeinteger

Example:1684814400000

Start time filter (UTC milliseconds)

endTimeinteger

Example:1672549200000

End time filter (UTC milliseconds)

Response

Paginated list of funding fee payments, most recent first

successboolean required

Whether the request was successful

errorstring

Error message, present only on failure

error_codestring

Semantic error code. See each endpoint's error responses for the specific codes it can return.

deprecatedstring

Deprecation notice, if applicable

Example response

{
  "success": true,
  "result": [
    {
      "market": "AAPL-USD.P",
      "time": "2022-06-16T12:35:10.123456Z",
      "markPrice": "12.03",
      "positionSize": "1.00",
      "positionDirection": "long",
      "rate": "0.0000125",
      "payer": "long",
      "amount": "-0.16402"
    }
  ],
  "pageInfo": {
    "prevCursor": "O4ZTGM3RGM2DG===",
    "nextCursor": "NQ5WWO3THN3Q===="
  }
}