查询账户信息
查询账户信息
查询用户的账户信息,包括余额、保证金、账户价值等。
HTTP 请求
GET
/api/perp-trade-api/curr-info/account
请求频率限制:
- 建议不超过 10 次/秒
认证要求:
- 需要 JWT Token
- 需要 X-Wallet-Address 请求头
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | JWT Token,格式:Bearer {token} |
| X-Wallet-Address | string | 是 | 钱包地址 |
请求参数
无需参数
响应字段说明
| 名称 | 类型 | 描述 |
|---|---|---|
| address | string | 地址 |
| canTrade | boolean | 是否可以交易 |
| updateTime | long | 更新时间(毫秒) |
| feeTier | string | 手续费等级 |
| walletBalance | string | 钱包余额 |
| totalPositionMargin | string | 总仓位保证金 |
| totalUnrealizedProfit | string | 总未实现盈亏 |
| freeCollateral | string | 可用保证金 |
| accountValue | string | 账户价值 |
| accountDataByMarket | array | 各市场账户数据 |
每个市场账户数据包含:
| 名称 | 类型 | 描述 |
|---|---|---|
| symbol | string | 交易对 |
| ... | ... | 其他市场相关数据 |
响应示例
{
"code": 200,
"message": "success",
"data": {
"address": "0xab7f6e97232d633689cf762989455cceb769587c69a9f09a23f537f5605f9e78",
"canTrade": true,
"updateTime": 1700000000000,
"feeTier": "1",
"walletBalance": "10000",
"totalPositionMargin": "500",
"totalUnrealizedProfit": "5",
"freeCollateral": "9505",
"accountValue": "10005",
"accountDataByMarket": [
{
"symbol": "ETH-PERP",
...
}
]
}
}