跳至主要内容

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

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

覆蓋範圍: SPOT / USDT永續 / USDT交割 / USDC永續 / USDC交割 / 反向合約

警告
  • 托管子账户不支持查询

HTTP請求​

GET /v5/account/instruments-info

請求參數​

參數是否必需類型說明
categorytruestring產品類型. spot,linear,inverse
symbolfalsestring合約名稱
limitfalseinteger每頁數量限制. [1, 200]. 默認: 200
cursorfalsestring游標，用於翻頁

響應參數​

參數類型說明
categorystring產品類型
nextPageCursorstring游標，用於翻頁
listarrayObject
> symbolstring合約名稱
> contractTypestring合約類型
> statusstring合約狀態
> baseCoinstring交易幣種
> quoteCoinstring報價幣種
> symbolTypestring 交易對所屬區域
> 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資金費率下限
    > displayNamestring網頁或APP端展示的USDC永續和交割合約的名稱
    > riskParametersobject限價單價格風控參數, 參讀該公告內容
    >> priceLimitRatioXstring參數X
    >> priceLimitRatioYstring參數Y
    > isPreListingboolean
  • 該合約是否為盤前合約
  • 當盤前合約轉為正式合約後, 值將變成false
    • > preListingInfoobject
  • 如果isPreListing=false, preListingInfo=null
  • 如果isPreListing=true, preListingInfo是object
    • >> curAuctionPhasestring當前的盤前階段
    >> phasesarray<object>每個階段的時間信息
    >>> phasestring盤前交易階段
    >>> startTimestring該階段的開始時間戳(毫秒)
    >>> endTimestring該階段的結束時間戳(毫秒)
    >> auctionFeeInfoobject盤前交易手續費率信息
    >>> auctionFeeRatestring集合競價期間的手續費率
  • 目前, 僅在連續競價期間才會產生手續費
    • >>> takerFeeRatestring連續競價期間的吃單成交手續費率
    >>> makerFeeRatestring連續競價期間的掛單成交手續費率
    > isPublicRpi boolean是否公開給做市商進行 RPI
  • true: 公開給做市商進行 RPI
  • false: 没有公開給做市商進行 RPI
    • > myRpiPermission boolean當前使用者是否有RPI權限
  • true: 有RPI權限
  • false: 没有有RPI權限

    • 請求示例​

    GET /v5/account/instruments-info?category=linear&symbol=1000000BABYDOGEUSDT HTTP/1.1
    Host: api-testnet.bybit.com

    響應示例​

    // official USDT Perpetual instrument structure
    {
        "retCode": 0,
        "retMsg": "OK",
        "result": {
            "category": "linear",
            "list": [
                {
                    "symbol": "1000000BABYDOGEUSDT",
                    "contractType": "LinearPerpetual",
                    "status": "Trading",
                    "baseCoin": "1000000BABYDOGE",
                    "quoteCoin": "USDT",
                    "launchTime": "1718098044000",
                    "deliveryTime": "0",
                    "deliveryFeeRate": "",
                    "priceScale": "7",
                    "leverageFilter": {
                        "minLeverage": "1",
                        "maxLeverage": "25.00",
                        "leverageStep": "0.01"
                    },
                    "priceFilter": {
                        "minPrice": "0.0000001",
                        "maxPrice": "1.9999998",
                        "tickSize": "0.0000001"
                    },
                    "lotSizeFilter": {
                        "maxOrderQty": "60000000",
                        "minOrderQty": "100",
                        "qtyStep": "100",
                        "postOnlyMaxOrderQty": "60000000",
                        "maxMktOrderQty": "12000000",
                        "minNotionalValue": "5"
                    },
                    "unifiedMarginTrade": true,
                    "fundingInterval": 240,
                    "settleCoin": "USDT",
                    "copyTrading": "none",
                    "upperFundingRate": "0.02",
                    "lowerFundingRate": "-0.02",
                    "isPreListing": false,
                    "preListingInfo": null,
                    "riskParameters": {
                        "priceLimitRatioX": "0.15",
                        "priceLimitRatioY": "0.3"
                    },
                    "displayName": "",
                    "symbolType": "innovation",
                    "myRpiPermission": true,
                    "isPublicRpi": true
                }
            ],
            "nextPageCursor": ""
        },
        "retExtInfo": {},
        "time": 1760510800094
    }