跳到主要内容

获取交易品种信息

API说明​

此接口提供所有现货交易品种的详细信息，包括最低和最高订单价格、订单数量和价格精度。

注意：交易品种信息数据只能通过 RESTful API 获取。

注意事项​

  1. 此接口返回所有交易品种的信息，不需要参数来查询特定交易品种。要访问特定交易品种的数据，请在返回的响应中查找。

认证​

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

请求方法​

GET

接口地址​

/api/v1/public?command=returnSymbol

频率限制​

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

请求参数​

此接口不需要任何请求参数。

响应参数​

参数类型描述
currencyPairString交易品种，例如BTC_USDT。
currencyBaseString基础货币，例如BTC。
currencyQuoteString报价货币，例如USDT。
maxBuyCountString最大交易量，单位是基础货币，比如交易品种是BTCUSDT。
minBuyCountString最小交易量，单位是基础货币，比如交易品种是BTCUSDT，minBuyCount值是0.0001，就表示最小交易量是0.0001个BTC。
pricePrecisionInteger价格精度
countPrecisionInteger数量精度
minBuyAmountString最小交易金额，单位是报价货币，比如交易品种是BTCUSDT，minBuyAmount值是5，就表示最小交易金额是5个USDT。
maxBuyAmountString最大交易金额，单位是报价货币，比如交易品种是BTCUSDT。
minBuyPriceString最小成交价格，单位是报价货币，比如交易品种是BTCUSDT，minBuyPrice值是0.001，就表示最小成交价是0.001USDT。
maxBuyPriceString最大成交价格，单位是报价货币，比如交易品种是BTCUSDT。
stateInteger交易品种状态
1：正常，
2：禁用

请求示例​

以下Python代码展示了如何获取交易品种信息。

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

api_url= "/api/v1/public?command=returnSymbol"
params= {}
SpotRestfulPublic(api_url, params)   # 函数SpotRestfulPublic()在章节(简介 > 认证和代码示例 > 现货 > RESTful公共接口)中定义

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

响应示例​

以下是上述Python请求返回的示例响应。为简洁起见，仅显示BTC和ETH的信息：

{'code': '200',
 'data': [
{'currencyBase': 'BTC',
 'maxBuyCount': '9999999.00000000000000000000',
 'pricePrecision': 2,
 'minBuyPrice': '0.00100000000000000000',
 'currencyPair': 'BTC_USDT',
 'minBuyAmount': '5.00000000000000000000',
 'maxBuyPrice': '99999999.00000000000000000000',
 'currencyQuote': 'USDT',
 'countPrecision': 4,
 'minBuyCount': '0.00010000000000000000',
 'state': 1,
 'maxBuyAmount': '99999999.00000000000000000000'},
{'currencyBase': 'ETH',
 'maxBuyCount': '99999999.00000000000000000000',
 'pricePrecision': 2,
 'minBuyPrice': '0.00100000000000000000',
 'currencyPair': 'ETH_USDT',
 'minBuyAmount': '5.00000000000000000000',
 'maxBuyPrice': '99999999.00000000000000000000',
 'currencyQuote': 'USDT',
 'countPrecision': 4,
 'minBuyCount': '0.00010000000000000000',
 'state': 1,
 'maxBuyAmount': '99999999.00000000000000000000'},......], 
'msg': 'SUCCESS',
 'success': True, 
'failed': False}