获取所有交易品种24小时交易摘要
API说明
此接口提供交易所所有可用交易品种的24小时交易摘要,包括最新成交价、最高买价、最低卖价、24小时交易量等关键指标。
注意:交易品种24小时交易摘要数据可通过RESTful和Websocket接口获取。本页是RESTful接口的描述。如需了解Websocket接口,请参见 跳转
注意事项
- 此接口返回所有交易品种的信息,不需要参数来查询特定交易品种。要访问特定交易品种的数据,请在返回的响应中查找。
- 对于实时更新,建议使用Websocket接口。
认证
这是一个公共接口,不需要认证。有关使用RESTful API的详细信息,请参考简介 > 认证和代码示例 > 现货 > RESTful公共接口。
请求方法
GET
接口地址
/api/v1/public?command=returnTicker
频率限制
该接口的调用频率限制为:每个 IP 每秒最多请求80次。
此外,该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息,请参阅“频率限制”部分,跳转
请求参数
此接口不需要任何请求参数。
响应参数
| 参数 | 类型 | 描述 |
|---|---|---|
| id | String | 货币对 ID,例如,"78"表示BTC_USDT。 |
| last | String | 最新价格 |
| lowestAsk | String | 卖价 |
| highestBid | String | 买价 |
| percentChange | String | 价格变化 |
| isFrozen | String | 是否冻结:0:否,1:是 |
| high24hr | String | 24小时最高价 |
| low24hr | String | 24小时最低价 |
| baseVolume | String | 24小时以报价货币计的交易量 |
请求示例
以下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
}