Instrument Info

Get launched instruments information.

HTTP Request

GET /derivatives/v3/public/instruments-info

Request Parameters

Parameter	Required	Type	Comments
category	false	string	Product type. linear,inverse,option. Default: returns futures
symbol	false	string	Symbol name. query an option symbol, category is required
baseCoin	false	string	Base coin. Valid when category=option BTC by default if not passed
limit	false	integer	Limit for data size per page. [1, 1000]. Default: 500
cursor	false	string	Cursor. Use the nextPageCursor token from the response to retrieve the next page of the result set

Response Parameters

Linear/Inverse

Parameter	Type	Comments
category	string	Derivatives products category. Keeps empty string `""` when `category` is not passed
list	array	Object
> symbol	string	Symbol name
> contractType	string	Contract type. `LinearPerpetual`, `InversePerpetual`, `InverseFutures`
> status	string	Symbol status
> baseCoin	string	Base coin. e.g BTCUSDT, BTC is base coin
> quoteCoin	string	Quote coin. e.g BTCPERP, USDC is quote coin
> settleCoin	string	Settle coin. e.g BTCUSD, BTC is settle coin
> launchTime	string	The launch timestamp (ms)
> deliveryTime	string	The delivery timestamp (ms). "0" for perpetual
> deliveryFeeRate	string	The delivery fee rate
> priceScale	string	Price scale
> leverageFilter	Object
>> minLeverage	string	Min. leverage
>> maxLeverage	string	Max. leverage
>> leverageStep	string	The min step to modify leverage
> priceFilter	Object
>> minPrice	string	Min. order price
>> maxPrice	string	Max. order price
>> tickSize	string	Tick size
> lotSizeFilter	Object
>> minNotionalValue	string	Minimum notional value
>> maxOrderQty	string	Max. trade quantity per order
>> minOrderQty	string	Min. trade quantity per order
>> qtyStep	string	Min. order quantity increment
>> maxMktOrderQty	string	Maximum quantity for Market order
>> postOnlyMaxOrderQty	string	Depreciated, please use maxOrderQty
> unifiedMarginTrade	boolean	Support unified margin trade or not
> fundingInterval	integer	Funding interval (minute)
nextPageCursor	string	The cursor used to pagination

option

Parameter	Type	Comments
category	string	Derivatives products category. Keeps empty string `""` when `category` is not passed
list	array	Object
> category	string	Derivatives products category
> symbol	string	Symbol name
> status	string	Symbol status
> baseCoin	string	Base coin. e.g BTC-17NOV22-16750-C, BTC is base coin
> quoteCoin	string	Quote coin
> settleCoin	string	Settle coin
> optionsType	string	Option type. `Call` or `Put`
> launchTime	string	The launch timestamp (ms)
> deliveryTime	string	The delivery timestamp (ms)
> deliveryFeeRate	string	The delivery fee rate
> priceFilter	Object
>> minPrice	string	Min. order price
>> maxPrice	string	Max. order price
>> tickSize	string	Tick size
> lotSizeFilter	Object
>> maxOrderQty	string	Max. trade quantity per order
>> minOrderQty	string	Min. trade quantity per order
>> qtyStep	string	Min. order quantity increment

Request Example

linear

GET /derivatives/v3/public/instruments-info?symbol=BTCPERP&category=linear HTTP/1.1
Host: api.bybit.com

option

GET /derivatives/v3/public/instruments-info?symbol=BTC-30DEC22-19000-C&category=option HTTP/1.1
Host: api.bybit.com

Response Example

js linear

{
    "retCode": 0,
    "retMsg": "OK",
    "result": {
    "category": "linear",
    "list": [
        {
            "symbol": "BTCPERP",
            "contractType": "LinearPerpetual",
            "status": "Trading",
            "baseCoin": "BTC",
            "quoteCoin": "USD",
            "launchTime": "1610604231000",
            "deliveryTime": "0",
            "deliveryFeeRate": "",
            "priceScale": "2",
            "leverageFilter": {
                "minLeverage": "1",
                "maxLeverage": "125.00",
                "leverageStep": "0.01"
        },
            "priceFilter": {
                "minPrice": "0.50",
                "maxPrice": "999999.00",
                "tickSize": "0.50"
        },
            "lotSizeFilter": {
                "maxTradingQty": "20.000",
                "minTradingQty": "0.001",
                "qtyStep": "0.001",
                "postOnlyMaxOrderQty": "100.000",
                "maxOrderQty": "20.000",
                "minOrderQty": "0.001",
                "minNotionalValue": "5"
        },
            "unifiedMarginTrade": true,
            "fundingInterval": 480,
            "settleCoin": "USDC"
        }
    ],
    "nextPageCursor": ""
},
    "retExtInfo": {},
    "time": 1671969788515
}

js option

{
    "retCode": 0,
    "retMsg": "success",
    "result": {
        "category": "option",
        "nextPageCursor": "",
        "list": [
            {
                "category": "option",
                "symbol": "BTC-30DEC22-19000-C",
                "status": "ONLINE",
                "baseCoin": "BTC",
                "quoteCoin": "USD",
                "settleCoin": "USDC",
                "optionsType": "Call",
                "launchTime": "1657785600000",
                "deliveryTime": "1672387200000",
                "deliveryFeeRate": "0.00015",
                "priceFilter": {
                    "minPrice": "5",
                    "maxPrice": "10000000",
                    "tickSize": "5"
                },
                "lotSizeFilter": {
                    "maxOrderQty": "10000",
                    "minOrderQty": "0.01",
                    "qtyStep": "0.01"
                }
            }
    ]
},
    "retExtInfo": {},
    "time": 1671969917171
}