Skip to main content

Get Account Instruments Info

Query for the instrument specification of online trading pairs that available to users.

Covers: Spot / USDT contract / USDC contract / Inverse contract

caution
  • Spot does not support pagination, so limit, cursor are invalid.
  • This endpoint returns 200 entries by default. There are now more than 200 linear symbols on the platform. As a result, you will need to use cursor for pagination or limit to get all entries.
  • Custodial sub-accounts do not support queries.
  • During periods of extreme market volatility, this interface may experience increased latency or temporary delays in data delivery
  • The fields maxLimitOrderQty, maxMarketOrderQty, and postOnlyMaxLimitOrderSize are adjusted bi-monthly (3rd and 17th, 08:00 UTC+8). Developers should not assume these values remain constant.
Tradfi

There may be limited price movement and reduced liquidity outside the underlying asset’s regular trading hours on its primary market. During weekends, some symbols may be subject to position risk control, and only reduce-only orders are allowed.

HTTP Request​

GET/v5/account/instruments-info

Request Parameters​

ParameterRequiredTypeComments
categorytruestringProduct type. spot,linear,inverse
symbolfalsestringSymbol name, like BTCUSDT, uppercase only
limitfalseintegerLimit for data size per page. [1, 200]. Default: 200
cursorfalsestringCursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters​

ParameterTypeComments
categorystringProduct type
nextPageCursorstringCursor. Used to pagination
listarrayObject
> symbolstringSymbol name
> symbolIdintegerThe ID of symbol name
> contractTypestringContract type
> statusstringInstrument status
> baseCoinstringBase coin
> quoteCoinstringQuote coin
> symbolTypestringthe region to which the trading pair belongs
> launchTimestringLaunch timestamp (ms)
> deliveryTimestringDelivery timestamp (ms)
  • Expired futures delivery time
  • Perpetual delisting time
> deliveryFeeRatestringDelivery fee rate
> priceScalestringPrice scale
> leverageFilterObjectLeverage attributes
>> minLeveragestringMinimum leverage
>> maxLeveragestringMaximum leverage
>> leverageStepstringThe step to increase/reduce leverage
> priceFilterObjectPrice attributes
>> minPricestringMinimum order price
>> maxPricestringMaximum order price
>> tickSizestringThe step to increase/reduce order price
> lotSizeFilterObjectSize attributes
>> minNotionalValuestringMinimum notional value
>> maxOrderQtystringMaximum quantity for Limit and PostOnly order
>> maxMktOrderQtystringMaximum quantity for Market order
>> minOrderQtystringMinimum order quantity
>> qtyStepstringThe step to increase/reduce order quantity
>> postOnlyMaxOrderQtystringdeprecated, please use maxOrderQty
> unifiedMarginTradebooleanWhether to support unified margin trade
> fundingIntervalintegerFunding interval (minute)
> settleCoinstringSettle coin
> copyTradingstringCopy trade symbol or not
> upperFundingRatestringUpper limit of funding date
> lowerFundingRatestringLower limit of funding date
> displayNamestringThe USDC futures & perpetual name displayed in the Web or App
> riskParametersobjectRisk parameters for limit order price. Note that the formula changed in May 2026
>> priceLimitRatioXstringRatio X
>> priceLimitRatioYstringRatio Y
> isPreListingboolean
  • Whether the contract is a pre-market contract
  • When the pre-market contract is converted to official contract, it will be false
> preListingInfoobject
  • If isPreListing=false, preListingInfo=null
  • If isPreListing=true, preListingInfo is an object
>> curAuctionPhasestringThe current auction phase
>> phasesarray<object>Each phase time info
>>> phasestringpre-market trading phase
>>> startTimestringThe start time of the phase, timestamp(ms)
>>> endTimestringThe end time of the phase, timestamp(ms)
>> auctionFeeInfoobjectAction fee info
>>> auctionFeeRatestringThe trading fee rate during auction phase
  • There is no trading fee until entering continues trading phase
>>> takerFeeRatestringThe taker fee rate during continues trading phase
>>> makerFeeRatestringThe maker fee rate during continues trading phase
>> skipCallAuctionbooleanfalse, true Whether the pre-market contract skips the call auction phase
> isPublicRpibooleanIndicates whether RPI quoting is enabled for this symbol.
  • true: All users can submit RPI orders.
  • false: RPI orders are disabled for this symbol, and no users can submit them.
Note: The value may be delayed by up to 1 hour.
> myRpiPermission booleanDeprecated, and will always have the same value as isPublicRpi

Request Example​

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

Response Example​

// official USDT Perpetual instrument structure
{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
        "category": "linear",
        "list": [
            {
                "symbol": "1000000BABYDOGEUSDT",
                "symbolId": 527,
                "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
}