跳到主要内容

获取批量最新交易摘要

API说明​

该接口用于一次性查询多个交易品种的最新交易摘要，包括最高价、最低价、最大杠杆、成交量、最新成交价、合约张数等。

注意： 批量获取最新交易摘要仅支持 Restful API。

注意事项​

  1. 本接口支持通过逗号分隔的字符串，批量检索多个交易品种的信息。
  2. 单次请求最多可查询 20 个交易品种。
  3. 若需查询所有合约，请参考 合约 > 市场信息 > 获取所有交易品种最新交易摘要。
  4. 若需订阅实时成交数据，请使用 合约 > 市场信息 > 订阅24小时交易摘要。

请求方法​

GET

接口地址​

/v1/perpumPublic/ticker/list

频率限制​

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

请求参数​

参数名是否必填类型说明
symbols是String使用逗号分隔基础币，如 "BTC,ETH,1000PEPE"。注意：USDT 合约只需传入基础货币名称，如 BTCUSDT 传 BTC 即可；USDC 合约请传完整交易对，如 BTC_USDC。

响应参数​

字段类型说明
contract_idInteger合约类型：1 = USDT 永续合约
nameString合约名称，例如 BTCUSDT、BTCUSDC
base_coinString基础币，例如 btc
quote_coinString计价币，例如 usdt 或 usdc
price_coinString价格币
max_leverageInteger最大杠杆倍数
contract_sizeBigDecimal合约最小交易张数
last_priceBigDecimal最新成交价
highBigDecimal24H 最高价
lowBigDecimal24H 最低价
rise_fall_rateBigDecimal涨跌幅
total_volumeBigDecimal24H 成交量
fair_priceBigDecimal指数价格（标记价格）

请求示例​

以下 Python 代码演示了如何获取 BTC 和 ETH 的最新交易摘要。 注意：完整代码示例请参考 简介 > 认证和代码示例 > 合约交易 > RESTful公共接口。

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

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

响应示例​

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

{
  "code": 0,
  "data": [
    {
      "fair_price": 121268.0,
      "max_leverage": 125,
      "total_volume": 0.625,
      "price_coin": "btc",
      "contract_id": 1,
      "base_coin": "btc",
      "high": 123695.6,
      "rise_fall_rate": 0.000536,
      "low": 119764.5,
      "name": "BTCUSDT",
      "contract_size": 0.001,
      "quote_coin": "usdt",
      "last_price": 121268.0
    },
    {
      "fair_price": 2504.98,
      "max_leverage": 200,
      "total_volume": 240.45,
      "price_coin": "eth",
      "contract_id": 2,
      "base_coin": "eth",
      "high": 4440.18,
      "rise_fall_rate": -0.011815,
      "low": 4131.24,
      "name": "ETHUSDT",
      "contract_size": 0.01,
      "quote_coin": "usdt",
      "last_price": 4374.44
    }
  ],
  "msg": ""
}