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.
|
baseCoin | false | string | Base coin.
|
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
- option
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 | |
>> maxOrderQty | string | Max. trade quantity per order |
>> minOrderQty | string | Min. trade quantity per order |
>> qtyStep | string | Min. order quantity increment |
> unifiedMarginTrade | boolean | Support unified margin trade or not |
> fundingInterval | integer | Funding interval (minute) |
nextPageCursor | string | The cursor used to pagination |
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
- option
GET /derivatives/v3/public/instruments-info?symbol=BTCPERP&category=linear HTTP/1.1
Host: api.bybit.com
GET /derivatives/v3/public/instruments-info?symbol=BTC-30DEC22-19000-C&category=option HTTP/1.1
Host: api.bybit.com
Response Example
- js linear
- js option
{
"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"
},
"unifiedMarginTrade": true,
"fundingInterval": 480,
"settleCoin": "USDC"
}
],
"nextPageCursor": ""
},
"retExtInfo": {},
"time": 1671969788515
}
{
"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
}