跳到主要内容

获取现货账户余额

API说明​

此接口检索用户现货账户的可用余额，包括不同交易品种的所有持有量。

注意：资产数据可通过RESTful和Websocket接口获取。本页是RESTful接口的描述。如需了解Websocket接口，请参见 跳转

注意事项​

  1. 如果用户没有资产，将返回空响应。

认证​

这是一个私有接口，需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

请求方法​

POST

接口地址​

/api/v1/private?command=returnBalances

频率限制​

该接口的调用频率限制为：每个用户 ID 每秒最多请求3次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数​

此接口不需要任何请求参数。

响应参数​

响应包含交易品种名称和用户现货账户中持有的相应金额。

参数类型描述
dataJson包含所有持有量的数据对象。
msgStringSuccess

请求示例​

以下Python代码展示了如何获取用户现货账户的可用余额。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

api_url = "/api/v1/private?command=returnBalances"
method = "post"
params = {}
SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key)    # 函数SpotRestfulPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

响应示例​

以下是上述Python请求返回的示例响应：

{'code': '200',
 'data': {
  'BTC': '0.0012',
  'CWT': '400.000',
  'SAND': '108.467',
  'ETH': '0.0330',
  'USDT': '257.518301140000000'},
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}