Funding Settlements

Query Funding Settlement History

Query user's historical funding rate settlement records.

HTTP Request

GET

/api/perp-trade-api/history/funding-settlements

Request Frequency Restriction:

• Recommended: no more than 10 times per second

Authentication Required:

• JWT Token required
• X-Wallet-Address header required

Request Headers

Name	Type	Required	Description
Authorization	string	Yes	JWT Token, format: Bearer {token}
X-Wallet-Address	string	Yes	Wallet address

Request Parameters

Name	Type	Required	Description
symbol	string	No	Trading pair, e.g., ETH-PERP, if not provided, query all trading pairs
pageNum	integer	No	Page number, default is 1
pageSize	integer	No	Page size, default is 20
beginTime	long	No	Start time (milliseconds), default is 90 days ago

Response Fields Description

Returns paginated response, containing:

Name	Type	Description
total	long	Total number of records
pageNum	integer	Current page number
pageSize	integer	Page size
list	array	Settlement record list

Each settlement record contains:

Name	Type	Description
id	long	Record ID
txDigest	string	Transaction digest
account	string	Account address
settlementAmount	string	Settlement amount
symbol	string	Trading pair
size	string	Position size
positionIsLong	integer	Whether long position (1-long, 0-short)
oraclePrice	string	Oracle price
fundingRate	string	Funding rate
createdAt	long	Creation time (milliseconds)

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "total": 50,
    "pageNum": 1,
    "pageSize": 20,
    "list": [
      {
        "id": 1,
        "txDigest": "0xabc123...",
        "account": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
        "settlementAmount": "0.5",
        "symbol": "ETH-PERP",
        "size": "1",
        "positionIsLong": 1,
        "oraclePrice": "2500",
        "fundingRate": "0.0001",
        "createdAt": 1700000000000
      }
    ]
  }
}