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

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
> 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 Jan 2025
>> 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
> isPublicRpi booleanWhether RPI Is Openly Provided to Market Makers or not.
  • true: RPI Is Openly Provided to Market Makers
  • false: RPI Is Not Openly Provided to Market Makers
> myRpiPermission booleanWhether the Current User Has RPI Permissions or not
  • true: Has RPI Permissions
  • false: Does Not Have RPI Permissions

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",
                "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
}