获取合约信息

GET /capi/v3/market/exchangeInfo

权重(IP): 1

请求参数

参数名	类型	是否必填	说明
symbol	String	否	交易对；留空时返回全部支持的合约与资产信息。
contractType	String	否	合约类型，支持值：`PERPETUAL`、`TRADIFI_PERPETUAL`。
underlyingType	String	否	底层资产类型。
underlyingSubType	String	否	底层资产标签；返回结果中的 `underlyingSubType` 包含该值即匹配。

请求示例

Code
curl "https://api-contract.weex.com/capi/v3/market/exchangeInfo?symbol=BTCUSDT"

返回参数

参数名	类型	说明
assets	Array	抵押品资产列表。每个元素对应资产对象 (assets[])。
rateLimits	Array	API 访问限制。每个元素对应访问限制对象 (rateLimits[])。
symbols	Array	合约配置列表。每个元素对应合约对象 (symbols[])。

资产对象 (assets[])

字段名	类型	说明
asset	String	资产符号（抵押品）
marginAvailable	Boolean	是否可用于抵押

访问限制对象 (rateLimits[])

字段名	类型	说明
interval	String	限制时间单位，例如 `MINUTE`。
intervalNum	Integer	时间单位数量，例如 `1`。
limit	Integer	指定时间周期内的上限次数。
rateLimitType	String	限制类型，例如 `REQUEST_WEIGHT` 或 `ORDERS`。

合约对象 (symbols[])

字段名	类型	说明
symbol	String	合约名称（如 BTCUSDT）
displaySymbol	String	页面展示交易币对名称
baseAsset	String	基础资产
quoteAsset	String	报价资产
marginAsset	String	保证金资产
contractType	String	合约类型，支持值：`PERPETUAL`、`TRADIFI_PERPETUAL`
underlyingType	String	底层资产类型
underlyingSubType	Array	底层资产标签
pricePrecision	Integer	价格精度
quantityPrecision	Integer	数量精度
baseAssetPrecision	Integer	基础资产数量精度
quotePrecision	Integer	报价资产数量精度
contractVal	Decimal	合约面值
delivery	Array	资金费/结算时间点
forwardContractFlag	Boolean	是否为正向合约（USDT 本位）
minLeverage	Integer	最小杠杆倍率
maxLeverage	Integer	最大杠杆倍率
buyLimitPriceRatio	Decimal	买单限价比例
sellLimitPriceRatio	Decimal	卖单限价比例
makerFeeRate	Decimal	合约 Maker 手续费率
takerFeeRate	Decimal	合约 Taker 手续费率
apiMakerFeeRate	Decimal	通过 API 接口下单的 Maker 手续费率，会存在不返回该字段情况。
apiTakerFeeRate	Decimal	通过 API 接口下单的 Taker 手续费率，会存在不返回该字段情况。
minOrderSize	Decimal	最小下单数量（基础币）
maxOrderSize	Decimal	最大下单数量（基础币）
maxPositionSize	Decimal	最大持仓数量（基础币）
marketOpenLimitSize	Decimal	市价开仓单次数量上限（基础币）

返回示例

Code
{
  "assets": [
    {
      "asset": "BTC",
      "marginAvailable": false
    },
    {
      "asset": "USDT",
      "marginAvailable": true
    }
  ],
  "rateLimits": [
    {
      "rateLimitType": "REQUEST_WEIGHT",
      "interval": "SECOND",
      "intervalNum": 10,
      "limit": 2000
    },
    {
      "rateLimitType": "ORDERS",
      "interval": "SECOND",
      "intervalNum": 10,
      "limit": 5
    }
  ],
  "symbols": [
    {
      "symbol": "BTCUSDT",
      "displaySymbol": "BTCUSDT",
      "baseAsset": "BTC",
      "quoteAsset": "USDT",
      "marginAsset": "USDT",
      "contractType": "PERPETUAL",
      "underlyingType": "COIN",
      "underlyingSubType": [
        "PoW"
      ],
      "pricePrecision": 1,
      "quantityPrecision": 6,
      "baseAssetPrecision": 3,
      "quotePrecision": 8,
      "contractVal": 0.000001,
      "delivery": [
        "00:00:00",
        "06:00:00",
        "12:00:00",
        "18:00:00"
      ],
      "forwardContractFlag": true,
      "minLeverage": 1,
      "maxLeverage": 408,
      "buyLimitPriceRatio": 0.016,
      "sellLimitPriceRatio": 0.015,
      "makerFeeRate": 0,
      "takerFeeRate": 0.001,
      "apiMakerFeeRate": 0.0002,
      "apiTakerFeeRate": 0.0008,
      "minOrderSize": 0.0001,
      "maxOrderSize": 10000,
      "maxPositionSize": 20000000,
      "marketOpenLimitSize": 12000
    }
  ]
}