跳到主要内容

获取所有交易品种最新交易摘要

API说明​

此接口允许查询交易所上所有交易品种最新交易摘要，包括最高价格、最低价格、最大杠杆率、总交易量、最新价格、合约大小等。

注意：所有交易品种最新交易摘要数据只能通过 RESTful API 获取

注意事项​

无

认证​

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

请求方法​

GET

接口地址​

/v1/perpumPublic/tickers

频率限制​

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

请求参数​

此接口不需要请求参数。

响应参数​

参数类型描述
contract_idInteger合约类型 1：U本位永续合约
nameString交易品种，例如BTCUSDT
base_coinString交易品种基础货币，例如btc
quote_coinString交易品种报价货币，例如usdt
price_coinString交易品种基础货币，例如btc
max_leverageInteger允许的最大杠杆率
contract_sizeBigDecimal可交易的最小单位
last_priceBigDecimal最新成交价
highBigDecimal最高价格
lowBigDecimal最低价格
rise_fall_rateBigDecimal价格变化
total_volumeBigDecimal总交易量
fair_priceBigDecimal指数价格

请求示例​

以下Python代码展示了如何获取所有交易品种最新交易摘要。

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

api_url = "/v1/perpumPublic/tickers"
 
params = { }    
FuturesRestfulPublic(api_url, params) # function FuturesRestfulPublic() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface)

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

响应示例​

以下是上述Python请求返回的示例响应。为简洁起见，仅显示BTC和ETH的交易摘要：

{'code': 0, 'data':[
{'fair_price': 97072.4,
  'max_leverage': 125,
  'total_volume': 0.003,
  'price_coin': 'btc',
  'contract_id': 1,
  'base_coin': 'btc',
  'high': 98001.5,
  'rise_fall_rate': 0.012275,
  'low': 95371.4,
  'name': 'BTCUSDT',
  'contract_size': 0.001,
  'quote_coin': 'usdt',
  'last_price': 97072.4},
 {'fair_price': 2725.39,
  'max_leverage': 100,
  'total_volume': 0.17,
  'price_coin': 'eth',
  'contract_id': 2,
  'base_coin': 'eth',
  'high': 2769.21,
  'rise_fall_rate': 0.011044,
  'low': 2693.3,
  'name': 'ETHUSDT',
  'contract_size': 0.01,
  'quote_coin': 'usdt',
  'last_price': 2725.39}.......],
 'msg': ''}