查询资金费率结算

查询资金费率结算记录

查询用户的历史资金费率结算记录。

HTTP 请求

GET

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

请求频率限制:

• 建议不超过 10 次/秒

认证要求:

• 需要 JWT Token
• 需要 X-Wallet-Address 请求头

请求头

名称	类型	必填	描述
Authorization	string	是	JWT Token，格式：Bearer {token}
X-Wallet-Address	string	是	钱包地址

请求参数

名称	类型	必填	描述
symbol	string	否	交易对，如 ETH-PERP，不传则查询所有交易对
pageNum	integer	否	页码，默认为 1
pageSize	integer	否	每页大小，默认为 20
beginTime	long	否	开始时间（毫秒），默认 90 天前

响应字段说明

返回分页响应，包含：

名称	类型	描述
total	long	总记录数
pageNum	integer	当前页码
pageSize	integer	每页大小
list	array	结算记录列表

每个结算记录包含：

名称	类型	描述
id	long	记录 ID
txDigest	string	交易摘要
account	string	账户地址
settlementAmount	string	结算金额
symbol	string	交易对
size	string	持仓大小
positionIsLong	integer	是否多头（1-多头，0-空头）
oraclePrice	string	预言机价格
fundingRate	string	资金费率
createdAt	long	创建时间（毫秒）

响应示例

{
  "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
      }
    ]
  }
}