Get Batch Last Trade Summary

API Description

This interface allows querying the latest trade summary for multiple trading instruments at once. This trade summary includes the highest price, lowest price, maximum leverage, total trading volume, latest price and contract size.

Note: Batch Last Trade Summary is only available via RESTful API.

Precautions

1. This interface supports retrieving information for multiple trading instruments using a comma-separated string.
2. Maximum of 20 instruments information can be retrieved in a request.
3. To query the latest trade summary for all instruments, please refer to Futures > Market Information > Get Last Trade Summary of All Instruments.
4. To get the real-time trade summary of an instrument, use the Websocket API under Futures > Market Information > Subscribe 24H Trade Summary

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/perpumPublic/ticker/list

Frequency Limit

The frequency limit for this interface is 1 requests/5s 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
contract_id	Integer	Contract Type 1: Linear perpetual
name	String	Instrument name, e.g., BTCUSDT.
base_coin	String	Base currency of the instrument, e.g., btc.
quote_coin	String	Quote currency of the instrument, e.g., usdt.
price_coin	String	Base currency of the instrument, e.g., btc.
max_leverage	Integer	Maximum leverage allowed.
contract_size	BigDecimal	The minimum contract size that can be traded.
last_price	BigDecimal	Latest traded price of the contract.
high	BigDecimal	Highest price in the latest trade summary.
low	BigDecimal	Lowest price in the latest trade summary.
rise_fall_rate	BigDecimal	Price change
total_volume	BigDecimal	Total trading volume of the contract.
fair_price	BigDecimal	Index price of the contract.

Request Example

The following Python code shows how to get the latest trade summary of BTC and ETH.

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

api_url = "/v1/perpumPublic/ticker/list"
 
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": [
    {
      "fair_price": 121268.0,
      "max_leverage": 125,
      "total_volume": 0.625,
      "price_coin": "btc",
      "contract_id": 1,
      "base_coin": "btc",
      "high": 123695.6,
      "rise_fall_rate": 0.000536,
      "low": 119764.5,
      "name": "BTCUSDT",
      "contract_size": 0.001,
      "quote_coin": "usdt",
      "last_price": 121268.0
    },
    {
      "fair_price": 2504.98,
      "max_leverage": 200,
      "total_volume": 240.45,
      "price_coin": "eth",
      "contract_id": 2,
      "base_coin": "eth",
      "high": 4440.18,
      "rise_fall_rate": -0.011815,
      "low": 4131.24,
      "name": "ETHUSDT",
      "contract_size": 0.01,
      "quote_coin": "usdt",
      "last_price": 4374.44
    }
  ],
  "msg": ""