跳至主要内容

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

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

覆蓋範圍: 現貨 / USDT永續 / USDC永續 / USDC交割 / 反向合約 / 期權

警告
  • 現貨不支持翻頁，因此limit, cusor無效.
  • 當通過baseCoin查詢時, 不管category=linear或inverse, 返回結果中都會包含USDT永續, USDC永續, USDC交割和反向合約的交易對.

HTTP請求​

GET /v5/market/instruments-info

請求參數​

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

    響應參數​

    參數類型說明
    categorystring產品類型
    nextPageCursorstring游標，用於翻頁
    listarrayObject
    > symbolstring合約名稱
    > contractTypestring合約類型
    > statusstring合約狀態
    > baseCoinstring交易幣種
    > quoteCoinstring報價幣種
    > launchTimestring發佈時間 (ms)
    > deliveryTimestring交割時間 (ms). 僅對交割合約有效
    > deliveryFeeRatestring交割費率. 僅對交割合約有效
    > priceScalestring價格精度
    > leverageFilterObject槓桿屬性
    >> minLeveragestring最小槓桿
    >> maxLeveragestring最大槓桿
    >> leverageStepstring修改槓桿的步長
    > priceFilterObject價格屬性
    >> minPricestring訂單最小價格
    >> maxPricestring訂單最大價格
    >> tickSizestring修改價格的步長
    > lotSizeFilterObject訂單數量屬性
    >> maxOrderQtystring單筆限價或PostOnly單最大下單量
    >> maxMktOrderQtystring單筆市價單最大下單量
    >> minOrderQtystring單筆訂單最小下單量
    >> qtyStepstring修改下單量的步長
    >> postOnlyMaxOrderQtystring廢棄, 請參照maxOrderQty
    >> minNotionalValuestring訂單最小名義價值
    > unifiedMarginTradeboolean是否支持統一保證金交易
    > fundingIntervalinteger資金費率結算週期 (分鐘)
    > settleCoinstring結算幣種
    > copyTradingstring當前交易對是否支持帶單交易
    > upperFundingRatestring資金費率上限
    > lowerFundingRatestring資金費率下限

    請求示例​

    GET /v5/market/instruments-info?category=linear&symbol=BTCUSDT HTTP/1.1
    Host: api-testnet.bybit.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.10",
                        "maxPrice": "199999.80",
                        "tickSize": "0.10"
                    },
                    "lotSizeFilter": {
                        "maxOrderQty": "100.000",
                        "maxMktOrderQty": "100.000",
                        "minOrderQty": "0.001",
                        "qtyStep": "0.001",
                        "postOnlyMaxOrderQty": "1000.000",
                        "minNotionalValue": "5"
                    },
                    "unifiedMarginTrade": true,
                    "fundingInterval": 480,
                    "settleCoin": "USDT",
                    "copyTrading": "both",
                    "upperFundingRate": "0.00375",
                    "lowerFundingRate": "-0.00375"
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1707186451514
    }