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
  • 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.

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