跳到主要内容

获取完整现货账户余额

API说明​

此接口允许用户检索其现货交易账户的完整余额详情。这里的“完整” 指的是数据维度的全面性，既包括可用余额，还包括被挂单冻结的余额，提供了账户的全貌视图，对于需要精确核算账户所有资金动向的应用场景，建议使用完整现货账户余额接口。

注意：完整现货账户余额数据只能通过 RESTful API 获取。

注意事项​

无

认证​

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

请求方法​

POST

接口地址​

/api/v1/private?command=returnCompleteBalances

频率限制​

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

请求参数​

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

响应参数​

参数类型描述
dataJson包含所有持有量的数据对象
-availableString可用余额
-onOrdersString冻结余额

请求示例​

以下Python代码展示了如何获取完整余额信息。

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

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

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

响应示例​

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

{'code': '200',
 'data': {'BTC': {'onOrders': '0', 'available': '0.0012'},
  'CWT': {'onOrders': '0', 'available': '400'},
  'SAND': {'onOrders': '0', 'available': '108.467'},
  'ETH': {'onOrders': '0', 'available': '0.033'},
  'USDT': {'onOrders': '0', 'available': '257.51830114'}},
 'msg': 'SUCCESS',
 'success': True,
 'failed': False}