获取指定交易品种最新交易摘要

API说明

此接口允许查询指定交易品种最新交易摘要，包括最高价格、最低价格、最大杠杆率、总交易量、最新价格和合约大小。

注意：交易品种最新交易摘要数据只能通过 RESTful API 获取。

注意事项

此接口支持查询特定交易品种最新交易摘要。要查询所有交易品种信息，请参考合约 > 市场信息 > 获取所有交易品种最新交易摘要。
要获取交易品种24小时实时交易摘要，请使用合约 > 市场信息 > 订阅24小时交易摘要。

认证

这是一个公共接口，不需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

请求方法

GET

接口地址

/v1/perpumPublic/ticker

频率限制

该接口的调用频率限制为：每个 IP 和用户 ID 每秒最多请求5次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数

参数	必填	类型	描述
instrument	true	String	注意：USDT 合约只需传入基础货币名称，如 `BTCUSDT` 传 `BTC` 即可；USDC 合约请传完整交易对，如 `BTC_USDC`。此参数不区分大小写。注意：对于以数字开头的交易品种（例如，1000PEPE），大写和小写格式均有效。

响应参数

参数	类型	描述
contract_id	Integer	合约类型 1：U本位永续合约
name	String	交易品种名称，例如BTCUSDT、BTCUSDC
base_coin	String	交易品种基础货币，例如btc
quote_coin	String	交易品种报价货币，例如usdt、usdc
price_coin	String	交易品种基础货币，例如btc
max_leverage	Integer	允许的最大杠杆率
contract_size	BigDecimal	可交易的最小合约大小
last_price	BigDecimal	合约最新成交价格
high	BigDecimal	最新交易摘要中的最高价格
low	BigDecimal	最新交易摘要中的最低价格
rise_fall_rate	BigDecimal	价格变化
total_volume	BigDecimal	交易量
fair_price	BigDecimal	指数价格

请求示例

以下Python代码展示了如何获取BTC的最新交易摘要。

注意：完整代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

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

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 合约 > RESTful公共接口。

响应示例

以下是上述Python请求返回的示例响应：

{'code': 0,
 'data': [{'fair_price': 97320.1,
   'max_leverage': 125,
   'total_volume': 0.0,
   'price_coin': 'btc',
   'contract_id': 1,
   'base_coin': 'btc',
   'high': 97362.5,
   'rise_fall_rate': 0.009628,
   'low': 95371.4,
   'name': 'BTCUSDT',
   'contract_size': 0.001,
   'quote_coin': 'usdt',
   'last_price': 97320.1}],
 'msg': ''}

API说明​

注意事项​

认证​

请求方法​

接口地址​

频率限制​

请求参数​

响应参数​

请求示例​

响应示例​