Get Batch Instruments Info

API Description

This interface allows querying the basic information for multiple trading instruments in a single request. This information includes leverages, margins, stop loss rate, take profit rate, maker/taker fee, settlement rate, maximum position size, etc.

Note: Batch Instruments Info is only available via RESTful API.

Precautions

This interface supports retrieving information for multiple trading instruments using a comma-separated string.
Maximum of 20 instruments information can be retrieved in a request.

Authentication

This is a public interface and does not require authentication. For details on using the Public RESTful API, please refer to Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface.

Request Method

GET

Endpoint

/v1/perpum/instrumentList

Frequency Limit

The frequency limit for this interface is 2 request/second per user ID and IP. In addition to this per-interface limit, a global rate limit is also enforced.

For detailed information on Global rate limits and API Rate Limiting Policy, please refer to the "Frequency Limit" section at click here

Request Parameters

Parameter	Mandatory	Type	Description
symbols	True	String	Specify multiple instruments via a comma-separated string. Example: "BTC,ETH,1000PEPE" Note: Specify only base currency for USDT margined coins i.e., BTC for BTCUSDT. Note: Maximum of 20 instruments are allowed in a request.

Response Parameters

Parameter	Type	Description
base	String	Base currency of the instrument e.g., BTC, ETH.
defaultLeverage	Integer	Default leverage assigned to the instrument.
defaultStopLossRate	BigDecimal	Default stop loss rate
defaultStopProfitRate	BigDecimal	Default take profit rate
indexId	Integer	Index ID
leverage	String	Available leverage options
makerFee	BigDecimal	Maker fee
maxLeverage	Integer	Maximum leverage allowed
minLeverage	Integer	Minimum leverage allowed
maxPosition	BigDecimal	Maximum position size allowed.
minSize	BigDecimal	Minimum order quantity in contracts.
name	String	Name of the base currency (e.g., BTC, ETH).
oneLotMargin	BigDecimal	Margin required per lot.
oneMaxPosition	BigDecimal	Maximum position size per lot.
pricePrecision	Integer	Number of decimal places for price precision (e.g., 2 for 0.01).
quote	String	Quote currency of the instrument (e.g., USDT).
settledAt	Long	Settlement timestamp
settlementRate	BigDecimal	Overnight fee rate
status	String	The current status of the instrument: offline: Not available for trading. online: Active and tradable. pretest: Pre-testing phase. settlement: In settlement process. preOffline: Pre-Ofline phase.
takerFee	BigDecimal	Taker fee
stopCrossPositionRate	Integer	Cross margin risk rate.
stopSurplusRate	Integer	Minimum remaining margin ratio.
updatedDate	BigDecimal	Timestamp of the last update.
sort	Integer	Sorting number
selected	Integer	Default selection status (0: No, 1: Yes).
openSpread	BigDecimal	Opening spread
oneLotSize	BigDecimal	Minimum contract size (equivalent to Base-size "contract value" on the web interface)
configBo	Json	Json string containing margin data
-margins	BigDecimal	List of margin tiers with corresponding deposits required.
-simulatedMargins	BigDecimal	Simulated margins (can be ignored)
closeSpread	BigDecimal	Closing spread
partitionIds	String	IDs for innovative zones (can be ignored)
commissionRate	BigDecimal	Commission rate
depthPrecision	String	Depth aggregation precision (can be ignored)
id	Integer	Contract ID
iconUrl	String	Icon URL
createdDate	Long	Launcing Date
settledPeriod	Integer	Settelment period

Request Example

The following Python code shows how to get the instrument information for BTC and ETH.

Note: For a complete code example, please refer to Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface.

api_url = "/v1/perpum/instrumentList"
params = {
    "symbols": "BTC,ETH"          
}
FuturesRestfulPublic(api_url, params)     #function FuturesRestfulPublic() is defined in section (Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface)

Note: For a complete Java code example, please refer to Introduction > Authentication & Code Snippet > Futures > RESTful Public Interface.

Response Example

The following is an example response returned by the above Python request:

{
  "code": 0,
  "data": [
    {
      "base": "btc",
      "closeSpread": 0.0002,
      "commissionRate": 0.0006,
      "configBo": {
        "margins": {
          "100": 0.075,
          "5": 0.00375,
          "50": 0.0375,
          "20": 0.015,
          "10": 0.0075
        },
        "simulatedMargins": {
          "5": 0.00375,
          "20": 0.015,
          "10": 0.0075
        }
      },
      "createdDate": 1548950400000,
      "defaultLeverage": 20,
      "defaultStopLossRate": 0.99,
      "defaultStopProfitRate": 100,
      "depthPrecision": "0.1,1,10,100",
      "iconUrl": "https://hkto-test.oss-accelerate.aliyuncs.com/811af5a9209c67c91346f313467438d10f0fc06a622a7e5e7291cf4a2cfaf17d.png",
      "id": 1,
      "indexId": 1,
      "leverage": [
        5,
        10,
        20,
        50,
        100,
        125,
        200
      ],
      "makerFee": "0.0004",
      "maxLeverage": 200,
      "maxPosition": 200000,
      "minLeverage": 1,
      "minSize": 1,
      "name": "BTC",
      "oneLotMargin": 1,
      "oneLotSize": 0.001,
      "oneMaxPosition": 15000,
      "openSpread": 0.0003,
      "partitionIds": "2013,2011",
      "pricePrecision": 1,
      "quote": "usdt",
      "selected": 0,
      "settledAt": 1760086800000,
      "settledPeriod": 1,
      "settlementRate": 0.0004,
      "sort": 1,
      "status": "online",
      "stopCrossPositionRate": 0.1,
      "stopSurplusRate": 0.01,
      "takerFee": "0.0006",
      "updatedDate": 1760083873000
    },
    {
      "base": "eth",
      "closeSpread": 0.0003,
      "commissionRate": 0.0006,
      "configBo": {
        "margins": {
          "100": 0.075,
          "5": 0.00375,
          "50": 0.0375,
          "20": 0.015,
          "10": 0.0075
        },
        "simulatedMargins": {
          "5": 0.00375,
          "20": 0.015,
          "10": 0.0075
        }
      },
      "createdDate": 1553101108000,
      "defaultLeverage": 200,
      "defaultStopLossRate": 0.985,
      "defaultStopProfitRate": 100,
      "depthPrecision": "0.01,0.1,1,10",
      "iconUrl": "https://hkto-prod.oss-accelerate.aliyuncs.com/201810011747047_OukYw.png",
      "id": 2,
      "indexId": 2,
      "leverage": [
        5,
        10,
        20,
        50,
        120,
        200
      ],
      "makerFee": "0.0004",
      "maxLeverage": 200,
      "maxPosition": 20000,
      "minLeverage": 1,
      "minSize": 1,
      "name": "ETH",
      "oneLotMargin": 1,
      "oneLotSize": 0.01,
      "oneMaxPosition": 20000,
      "openSpread": 0.0003,
      "partitionIds": "2013",
      "pricePrecision": 2,
      "quote": "usdt",
      "selected": 0,
      "settledAt": 1760112000000,
      "settledPeriod": 8,
      "settlementRate": 0.0004,
      "sort": 2,
      "status": "online",
      "stopCrossPositionRate": 0.1,
      "stopSurplusRate": 0.015,
      "takerFee": "0.0006",
      "updatedDate": 1760083873000
    }
  ],
  "msg": ""
}

API Description​

Precautions​

Authentication​

Request Method​

Endpoint​

Frequency Limit​

Request Parameters​

Response Parameters​

Request Example​

Response Example​