跳到主要内容

获取所有交易品种24小时交易摘要

API说明​

此接口提供交易所所有可用交易品种的24小时交易摘要，包括最新成交价、最高买价、最低卖价、24小时交易量等关键指标。

注意：交易品种24小时交易摘要数据可通过RESTful和Websocket接口获取。本页是RESTful接口的描述。如需了解Websocket接口，请参见 跳转

注意事项​

  1. 此接口返回所有交易品种的信息，不需要参数来查询特定交易品种。要访问特定交易品种的数据，请在返回的响应中查找。
  2. 对于实时更新，建议使用Websocket接口。

认证​

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

请求方法​

GET

接口地址​

/api/v1/public?command=returnTicker

频率限制​

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

请求参数​

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

响应参数​

参数类型描述
idString货币对 ID，例如，"78"表示BTC_USDT。
lastString最新价格
lowestAskString卖价
highestBidString买价
percentChangeString价格变化
isFrozenString是否冻结：0：否，1：是
high24hrString24小时最高价
low24hrString24小时最低价
baseVolumeString24小时以报价货币计的交易量

请求示例​

以下Python代码展示了如何获取所有交易品种的24小时交易摘要。

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

api_url= "/api/v1/public?command=returnTicker"
 
params= {}
SpotRestfulPublic(api_url, params)  # 函数SpotRestfulPublic()在章节(简介 > 认证和代码示例 > 现货 > RESTful公共接口)中定义

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

响应示例​

以下是上述Python请求返回的示例响应。为简洁起见，下面仅显示两个交易品种：

{'code': '200',
 'data': {
'BTC_USDT':
{'percentChange': '0.0135',
 'high24hr': '97371.79',
 'last': '96903.7',
 'highestBid': '96903.3200',
 'id': 78,
 'isFrozen': 0,
 'baseVolume': '773209171.37',
 'lowestAsk': '96904.3800',
 'low24hr': '95420.6'},
'ETH_USDT':
{'percentChange': '0.0102',
 'high24hr': '2757.0',
 'last': '2731.02',
 'highestBid': '2731.1400',
 'id': 79,
 'isFrozen': 0,
 'baseVolume': '220037399.94',
 'lowestAsk': '2731.2300',
 'low24hr': '2680.51'}......}
 'msg': 'SUCCESS', 
'success': True,
'failed': False
}