Get Last Trade Summary of All Instruments

API Description

This interface allows querying the latest trade summary for all instruments listed on the exchange, including the highest price, lowest price, maximum leverage, total trading volume, last price, contract size, etc.

Note: Last Trade Summary of All Instruments is only available via RESTful API.

Precautions

None

Authentication

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

Request Method

GET

Endpoint

/v1/perpumPublic/tickers

Frequency Limit

The frequency limit for this interface is 5 requests/s 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

This interface does not require request parameters.

Response Parameters

Parameter	Type	Description
contract_id	Integer	Contract Type 1: linear perpetuals
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 all instruments.

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

api_url = "/v1/perpumPublic/tickers"
 
params = { }    
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. For brevity, only the trade summaries for BTC and ETH are shown:

{'code': 0, 'data':[
{'fair_price': 97072.4,
  'max_leverage': 125,
  'total_volume': 0.003,
  'price_coin': 'btc',
  'contract_id': 1,
  'base_coin': 'btc',
  'high': 98001.5,
  'rise_fall_rate': 0.012275,
  'low': 95371.4,
  'name': 'BTCUSDT',
  'contract_size': 0.001,
  'quote_coin': 'usdt',
  'last_price': 97072.4},
 {'fair_price': 2725.39,
  'max_leverage': 100,
  'total_volume': 0.17,
  'price_coin': 'eth',
  'contract_id': 2,
  'base_coin': 'eth',
  'high': 2769.21,
  'rise_fall_rate': 0.011044,
  'low': 2693.3,
  'name': 'ETHUSDT',
  'contract_size': 0.01,
  'quote_coin': 'usdt',
  'last_price': 2725.39}.......],
 'msg': ''}