Skip to main content

Get Instruments Info

Query a list of instruments of online trading pair.

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

caution
  • Spot does not support pagination, so limit, cursor are invalid.
  • When query by baseCoin, regardless of category=linear or inverse, the result will have USDT perpetual, USDC contract and Inverse contract symbols.

HTTP Request

GET /v5/market/instruments-info

Request Parameters

ParameterRequiredTypeComments
categorytruestringProduct type. spot,linear,inverse,option
symbolfalsestringSymbol name
statusfalsestringSymbol status filter
  • spot/linear/inverse has Trading only
baseCoinfalsestringBase coin. linear,inverse,option only
limitfalseintegerLimit for data size per page. [1, 1000]. Default: 500
cursorfalsestringCursor. Used for pagination

Response Parameters

ParameterTypeComments
categorystringProduct type
nextPageCursorstringCursor. Used to pagination
listarrayObject
> symbolstringSymbol name
> contractTypestringContract type
> statusstringInstrument status
> baseCoinstringBase coin
> quoteCoinstringQuote coin
> launchTimestringLaunch timestamp (ms)
> deliveryTimestringDelivery timestamp (ms)
> 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
>> maxOrderQtystringMaximum order quantity
>> minOrderQtystringMinimum order quantity
>> qtyStepstringThe step to increase/reduce order quantity
>> postOnlyMaxOrderQtystringMaximum order qty for PostOnly order
> unifiedMarginTradebooleanWhether to support unified margin trade
> fundingIntervalintegerFunding interval (minute)
> settleCoinstringSettle coin

Request Example

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

Response Example

{
"retCode": 0,
"retMsg": "OK",
"result": {
"category": "linear",
"list": [
{
"symbol": "BTCUSDT",
"contractType": "LinearPerpetual",
"status": "Trading",
"baseCoin": "BTC",
"quoteCoin": "USDT",
"launchTime": "1585526400000",
"deliveryTime": "0",
"deliveryFeeRate": "",
"priceScale": "2",
"leverageFilter": {
"minLeverage": "1",
"maxLeverage": "100.00",
"leverageStep": "0.01"
},
"priceFilter": {
"minPrice": "0.50",
"maxPrice": "999999.00",
"tickSize": "0.50"
},
"lotSizeFilter": {
"maxOrderQty": "100.000",
"minOrderQty": "0.001",
"qtyStep": "0.001",
"postOnlyMaxOrderQty": "1000.000"
},
"unifiedMarginTrade": true,
"fundingInterval": 480,
"settleCoin": "USDT"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1672712495660
}