跳至主要内容

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

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

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

警告
  • 現貨不支持翻頁，因此limit, cusor無效
  • 托管子账户不支持查询
  • 在極端市場波動期間, 此介面可能會出現延遲增加或資料傳遞暫時延遲的情況

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連續競價期間的掛單成交手續費率
>> skipCallAuctionbooleanfalse, true 是否跳過集合競價階段
> 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
}