查询用户账户信息

查询用户账户信息 (鉴权类型: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"
      }
    ]
  }
}

results matching ""

    No results matching ""