Sign in
Trading

Get Funding Payments

Get funding payment history across all or filtered perpetual connectors.

This endpoint retrieves historical funding payment records including funding rates, payment amounts, and position data at time of payment.

Args: filter_request: JSON payload with filtering criteria

Returns: Paginated response with funding payment data and pagination metadata

Raises: HTTPException: 500 if there's an error fetching funding payments

post/trading/funding-payments

Request body

limitinteger

Number of items per page

start_timeinteger nullable

Start time as Unix timestamp in milliseconds

end_timeinteger nullable

End time as Unix timestamp in milliseconds

cursorstring nullable

Cursor for next page

account_namesstring[] nullable

List of account names to filter by

connector_namesstring[] nullable

List of connector names to filter by

trading_pairstring nullable

Filter by trading pair

Response

Successful Response

dataobject[] required
paginationobject required

Example response

{
  "data": [],
  "pagination": {
    "has_more": true,
    "limit": 100,
    "next_cursor": "2024-01-10T12:00:00",
    "total_count": 500
  }
}

Changes

Changed in 2 of the 13 revisions of this API.3

  • 92703f48a69e2See the full diff
    • ○

      added the optional property detail/items/ctx to the response with the 422 status

      response-optional-property-added

    • ○

      added the optional property detail/items/input to the response with the 422 status

      response-optional-property-added

    This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1005bcd472801See the full diff
    • ○

      endpoint added

      endpoint-added

    This revision also has 7 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog