跳至主要内容

查詢可交易產品的規格信息

查詢全站可交易產品的基礎配置規則信息

覆蓋範圍: 現貨 / USDT永續 / 反向合約

警告
  • 當通過baseCoin查詢時, 不管category=linear或inverse, 返回結果中都會包含USDT永續和反向合約的交易對.

HTTP請求​

GET /cloud/trade/v3/market/instruments-info

請求參數​

參數是否必需類型說明
categorytruestring產品類型. spot,linear,inverse
symbolfalsestring合約名稱
statusfalsestring交易對狀態篩選
baseCoinfalsestring交易貨幣.
僅對linear和inverse有效
limitfalseinteger每頁數量限制. [1, 1000]. 默認: 500
cursorfalsestring游標，用於翻頁

響應參數​

參數類型說明
categorystring產品類型
nextPageCursorstring游標，用於翻頁
listarrayObject
> symbolstring合約名稱
> contractTypestring合約類型
> statusstring合約狀態
> baseCoinstring交易幣種
> quoteCoinstring報價幣種
> launchTimestring發佈時間 (ms)
> priceScalestring價格精度
> leverageFilterObject槓桿屬性
>> minLeveragestring最小槓桿
>> maxLeveragestring最大槓桿
>> leverageStepstring修改槓桿的步長
> priceFilterObject價格屬性
>> minPricestring訂單最小價格
>> maxPricestring訂單最大價格
>> tickSizestring修改價格的步長
> lotSizeFilterObject訂單數量屬性
>> maxOrderQtystring單筆限價單最大下單量
>> maxMktOrderQtystring單筆市價單最大下單量
>> minOrderQtystring單筆訂單最小下單量
>> qtyStepstring修改下單量的步長
>> postOnlyMaxOrderQtystring廢棄, 請參照maxOrderQty
> fundingIntervalinteger資金費率結算週期 (分鐘)
> settleCoinstring結算幣種

請求示例​

GET /cloud/trade/v3/market/instruments-info?category=linear&symbol=BTCUSDT HTTP/1.1
Host: openapi-testnet.zoomex.com

響應示例​

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "category": "linear",
        "list": [
            {
                "symbol": "BTCUSDT",
                "contractType": "LinearPerpetual",
                "status": "Trading",
                "baseCoin": "BTC",
                "quoteCoin": "USDT",
                "launchTime": "1585526400000",
                "deliveryTime": "0",
                "deliveryFeeRate": "",
                "priceScale": "2",
                "leverageFilter": {
                    "minLeverage": "1",
                    "maxLeverage": "100.00",
                    "leverageStep": "0.01"
                },
                "priceFilter": {
                    "minPrice": "0.50",
                    "maxPrice": "999999.00",
                    "tickSize": "0.50"
                },
                "lotSizeFilter": {
                    "maxOrderQty": "100.000",
                    "minOrderQty": "0.001",
                    "qtyStep": "0.001",
                    "postOnlyMaxOrderQty": "1000.000"
                    "maxMktOrderQty": "1000.000"
                },
                "unifiedMarginTrade": true,
                "fundingInterval": 480,
                "settleCoin": "USDT"
            }
        ],
        "nextPageCursor": ""
    },
    "retExtInfo": {},
    "time": 1672712495660
}