跳到主要内容

获取批量交易品种信息

API说明​

该接口用于一次性查询多个交易品种的基础信息，包括杠杆倍数、保证金要求、止损率、止盈率、挂单/吃单手续费、结算汇率、最大持仓量等参数。

注意： 获取批量交易品种信息仅支持通过 RESTful API 获取。

注意事项​

  1. 本接口支持通过逗号分隔的字符串，批量查询多个交易品种的信息。
  2. 单次请求最多可查询20个交易品种。

认证​

该接口为公共接口，无需鉴权。 关于公共 RESTful API 的使用方式，请参考 简介 > 认证与代码示例 > 合约交易 > RESTful 公共接口。

请求方法​

GET

接口地址​

/v1/perpum/instrumentList

频率限制​

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

请求参数​

参数名是否必填类型说明
symbols是String使用逗号分隔的基础币种简称来指定多个交易品种。
例如："BTC,ETH,1000PEPE"
注意：USDT 合约只需传入基础货币名称，如 BTCUSDT 传 BTC 即可。单次请求最多允许指定20个交易品种。

响应参数​

字段类型说明
baseString合约基础币，例如 BTC、ETH。
defaultLeverageInteger默认杠杆倍数。
defaultStopLossRateBigDecimal默认止损比例。
defaultStopProfitRateBigDecimal默认止盈比例。
indexIdInteger索引 ID。
leverageString可选杠杆档位列表。
makerFeeBigDecimal挂单手续费率。
maxLeverageInteger最大可用杠杆倍数。
minLeverageInteger最小可用杠杆倍数。
maxPositionBigDecimal最大可持仓量。
minSizeBigDecimal最小下单张数。
nameString合约基础货币名称，如 BTC、ETH。
oneLotMarginBigDecimal每手所需保证金。
oneMaxPositionBigDecimal每手最大持仓量
pricePrecisionInteger价格精度的小数位数（例如，2表示0.01
quoteString计价币种，例如 USDT。
settledAtLong结算时间戳。
settlementRateBigDecimal资金费率
statusString合约状态：
offline（下线）、
online（交易中）、
pretest（预发布）、
settlement（结算中）、
preOffline（预下线）。
takerFeeBigDecimal吃单手续费率。
stopCrossPositionRateInteger全仓保证金风险率。
stopSurplusRateInteger最小剩余保证金率。
updatedDateBigDecimal最后更新时间戳。
sortInteger排序编号。
selectedInteger默认选择状态（0：否，1：是）。
openSpreadBigDecimal开仓点差。
oneLotSizeBigDecimal最小合约大小（等同于网页端的Base-size"合约面值"）。
configBoJson保证金档位 JSON 配置。
-marginsBigDecimal保证金层级列表及相应所需存款。
-simulatedMarginsBigDecimal模拟保证金（可以忽略）。
closeSpreadBigDecimal平仓点差。
partitionIdsString创新区 ID（可忽略）。
commissionRateBigDecimal佣金费率。
depthPrecisionString深度聚合精度（可忽略）。
idInteger合约 ID。
iconUrlString合约图标 URL。
createdDateLong上线时间。
settledPeriodInteger结算周期。

请求示例​

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

api_url = "/v1/perpum/instrumentList"
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": [
    {
      "base": "btc",
      "closeSpread": 0.0002,
      "commissionRate": 0.0006,
      "configBo": {
        "margins": {
          "100": 0.075,
          "5": 0.00375,
          "50": 0.0375,
          "20": 0.015,
          "10": 0.0075
        },
        "simulatedMargins": {
          "5": 0.00375,
          "20": 0.015,
          "10": 0.0075
        }
      },
      "createdDate": 1548950400000,
      "defaultLeverage": 20,
      "defaultStopLossRate": 0.99,
      "defaultStopProfitRate": 100,
      "depthPrecision": "0.1,1,10,100",
      "iconUrl": "https://hkto-test.oss-accelerate.aliyuncs.com/811af5a9209c67c91346f313467438d10f0fc06a622a7e5e7291cf4a2cfaf17d.png",
      "id": 1,
      "indexId": 1,
      "leverage": [
        5,
        10,
        20,
        50,
        100,
        125,
        200
      ],
      "makerFee": "0.0004",
      "maxLeverage": 200,
      "maxPosition": 200000,
      "minLeverage": 1,
      "minSize": 1,
      "name": "BTC",
      "oneLotMargin": 1,
      "oneLotSize": 0.001,
      "oneMaxPosition": 15000,
      "openSpread": 0.0003,
      "partitionIds": "2013,2011",
      "pricePrecision": 1,
      "quote": "usdt",
      "selected": 0,
      "settledAt": 1760086800000,
      "settledPeriod": 1,
      "settlementRate": 0.0004,
      "sort": 1,
      "status": "online",
      "stopCrossPositionRate": 0.1,
      "stopSurplusRate": 0.01,
      "takerFee": "0.0006",
      "updatedDate": 1760083873000
    },
    {
      "base": "eth",
      "closeSpread": 0.0003,
      "commissionRate": 0.0006,
      "configBo": {
        "margins": {
          "100": 0.075,
          "5": 0.00375,
          "50": 0.0375,
          "20": 0.015,
          "10": 0.0075
        },
        "simulatedMargins": {
          "5": 0.00375,
          "20": 0.015,
          "10": 0.0075
        }
      },
      "createdDate": 1553101108000,
      "defaultLeverage": 200,
      "defaultStopLossRate": 0.985,
      "defaultStopProfitRate": 100,
      "depthPrecision": "0.01,0.1,1,10",
      "iconUrl": "https://hkto-prod.oss-accelerate.aliyuncs.com/201810011747047_OukYw.png",
      "id": 2,
      "indexId": 2,
      "leverage": [
        5,
        10,
        20,
        50,
        120,
        200
      ],
      "makerFee": "0.0004",
      "maxLeverage": 200,
      "maxPosition": 20000,
      "minLeverage": 1,
      "minSize": 1,
      "name": "ETH",
      "oneLotMargin": 1,
      "oneLotSize": 0.01,
      "oneMaxPosition": 20000,
      "openSpread": 0.0003,
      "partitionIds": "2013",
      "pricePrecision": 2,
      "quote": "usdt",
      "selected": 0,
      "settledAt": 1760112000000,
      "settledPeriod": 8,
      "settlementRate": 0.0004,
      "sort": 2,
      "status": "online",
      "stopCrossPositionRate": 0.1,
      "stopSurplusRate": 0.015,
      "takerFee": "0.0006",
      "updatedDate": 1760083873000
    }
  ],
  "msg": ""
}