查询用户账户信息
查询用户账户信息 (鉴权类型:KEYED, 参见接口权限)
请求格式
GET https://api-cloud.bitmart.com/contract/v1/ifcontract/accounts
请求限制
参见 速率限制详细
请求参数
| 参数 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| coinCode | string | 是 | 合约账号，如：USDT |
解释说明
请求示例
curl https://api-cloud.bitmart.com/contract/v1/ifcontract/accounts?coinCode=USDT
响应详情
| 字段 | 类型 | 描述 |
|---|---|---|
| account_id | int | 账号 ID |
| coin_code | string | 代币名称 |
| freeze_vol | string | 冻结量 |
| available_vol | string | 可用余额 |
| cash_vol | string | 净现金余额 |
| realised_vol | string | 已实现盈亏 |
| unrealised_vol | string | 未实现盈亏 |
| created_at | string | 创建时间 |
| updated_at | string | 更新时间 |
备注
必须在币币系统登录成功后,才能获取用户的合约账号信息
请求参数有 contractID 和 coinCode.由于系统设计的是多个相同保证金 code 的合约共用一个合约账号,
所以该接口既可以通过合约 ID 查询合约账号,也可以通过 coinCode 查询合约账号.如果请求都不传,则返回用户的所有合约账号
返回数据格式示例
{
"code": 1000,
"trace":"886fb6ae-456b-4654-b4e0-d681ac05cea1",
"message": "OK",
"data": {
"accounts": [
{
"account_id": 10,
"coin_code": "USDT",
"freeze_vol": "1201.8",
"available_vol": "8397.65",
"cash_vol": "0",
"realised_vol": "-0.5",
"unrealised_vol": "-0.5",
"earnings_vol": "-0.5",
"created_at": "2018-07-13T16:48:49+08:00",
"updated_at": "2018-07-13T18:34:45.900387+08:00"
}
]
}
}