v1

latestOpenAPI 3.1.02026-07-265385123.6 KB

Account

Get user funding rate history

Retrieve funding rate payment history for a specific user. Shows funding payments including the direction, amount, and associated fees. Supports filtering by market, side, and timestamp range. Supports sorting and pagination. Page size is capped at 200.

get/api/v1/funding_rate_history

Query parameters

accountstring required

User account address (user query alias is also accepted)

marketstring

Filter by market address

side'buy' | 'sell'

Order side filter: buy (long) or sell (short). For orders, maps to is_buy column. For trades/funding, maps to action IN ('OpenLong','CloseShort') (buy) or action IN ('CloseLong','OpenShort') (sell).

Filter by side

limitinteger

Page size

offsetinteger

Page offset

start_timestampinteger

end_timestampinteger

sort_key'timestamp'

Sort key for history endpoints

sort_dir'ASC' | 'DESC'

Response

Funding rate history retrieved successfully

total_countinteger nullable

The total number of items across all pages. Optional: history endpoints omit this field to avoid expensive COUNT(*) queries.

Example response

{
  "items": [
    {
      "action": "Close Long",
      "market": "0xmarket123...",
      "realized_funding_amount": -15.5,
      "size": 1,
      "transaction_unix_ms": 1735758000000
    }
  ]
}