跳到主要内容

通用接口

测试服务器连通性 PING​

GET /api/v3/ping

测试能否联通

权重: 1

参数: NONE

数据源: 缓存

响应:

{}

获取服务器时间​

GET /api/v3/time

权重: 1

参数: NONE

数据源: 缓存

响应:

{
"serverTime": 1499827319559
}

交易规范信息​

GET /api/v3/exchangeInfo

获取此时的交易规范信息

权重: 20

参数:

名称类型是否必须描述
symbolSTRINGNO示例:curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC"
symbolsARRAY OF STRINGNO示例:curl -X GET
"https://api.binance.com/api/v3/exchangeInfo?symbols=%5B%22BNBBTC%22,%22BTCUSDT%22%5D"

或
curl -g -X GET
'https://api.binance.com/api/v3/exchangeInfo?symbols=["BTCUSDT","BNBBTC"]'
permissionsENUMNO示例:curl -X GET
"https://api.binance.com/api/v3/exchangeInfo?permissions=SPOT"

or
curl -X GET
"https://api.binance.com/api/v3/exchangeInfo?permissions=%5B%22MARGIN%22%2C%22LEVERAGED%22%5D"

or
curl -g -X GET
'https://api.binance.com/api/v3/exchangeInfo?permissions=["MARGIN","LEVERAGED"]'
showPermissionSetsBOOLEANNO默认值: true。
用于控制是否提供 permissionSets 字段的内容。
symbolStatusENUMNO用于过滤具有此 tradingStatus 的交易对。不能与 symbols 或 symbol 组合使用。

数据源: 缓存

备注:

  • 如果参数 symbol 或者 symbols 提供的交易对不存在, 系统会返回错误并提示交易对不正确。
  • 所有的参数都是可选的。
  • permissions 可以支持单个或多个值(例如 SPOT, ["MARGIN","LEVERAGED"])。此参数不能与 symbol 或 symbols 组合使用。
  • 如果未提供 permissions 参数,那么所有具有 SPOT、MARGIN 或 LEVERAGED 权限的交易对都将被返回。
    • 要显示具有任何权限的交易对,您需要在 permissions 中明确指定它们:(例如 ["SPOT","MARGIN",...])。有关完整列表,请参阅 [可用权限]

解释响应中的 permissionSets:

  • [["A","B"]] 有权限"A"或权限"B"的账户可以下订单。
  • [["A"],["B"]] 有权限"A"和权限"B"的账户可以下订单。
  • [["A"],["B","C"]] 有权限"A"和权限"B"或权限"C"的账户可以下订单。(此处应用的是包含或,而不是排除或,因此账户可以同时拥有权限"B"和权限"C"。)

响应:

{
"timezone": "UTC",
"serverTime": 1565246363776,
"rateLimits": [
{
"rateLimitType": "REQUEST_WEIGHT",
"interval": "MINUTE",
"intervalNum": 1,
"limit": 6000
},
{
"rateLimitType": "ORDERS",
"interval": "SECOND",
"intervalNum": 10,
"limit": 50
},
{
"rateLimitType": "ORDERS",
"interval": "DAY",
"intervalNum": 1,
"limit": 160000
},
{
"rateLimitType": "RAW_REQUESTS",
"interval": "MINUTE",
"intervalNum": 5,
"limit": 61000
}
],
// 交易所级别过滤器在 "过滤器" 页面上进行了说明:
// https://github.com/binance/binance-spot-api-docs/blob/master/filters_CN.md
// 全部交易过滤器是可选的。
"exchangeFilters": [],
"symbols": [
{
"symbol": "ETHBTC",
"status": "TRADING",
"baseAsset": "ETH",
"baseAssetPrecision": 8,
"quoteAsset": "BTC",
"quotePrecision": 8, // 将在未来的 api 版本中移除 (v4+)
"quoteAssetPrecision": 8,
"baseCommissionPrecision": 8,
"quoteCommissionPrecision": 8,
"orderTypes": [
"LIMIT",
"LIMIT_MAKER",
"MARKET",
"STOP_LOSS",
"STOP_LOSS_LIMIT",
"TAKE_PROFIT",
"TAKE_PROFIT_LIMIT"
],
"icebergAllowed": true,
"ocoAllowed": true,
"otoAllowed": true,
"opoAllowed": true,
"quoteOrderQtyMarketAllowed": true,
"allowTrailingStop": false,
"cancelReplaceAllowed": false,
"amendAllowed": false,
"pegInstructionsAllowed": true,
"isSpotTradingAllowed": true,
"isMarginTradingAllowed": true,
// 交易对过滤器在"过滤器"页面上进行了说明:
// https://github.com/binance/binance-spot-api-docs/blob/master/filters_CN.md
// 全部交易对过滤器是可选的。
"filters": [],
"permissions": [],
"permissionSets": [
[
"SPOT",
"MARGIN"
]
],
"defaultSelfTradePreventionMode": "NONE",
"allowedSelfTradePreventionModes": [
"NONE"
]
}
],
// 可选字段,仅当 SOR 可用时才会被显示出来。
// https://github.com/binance/binance-spot-api-docs/blob/master/faqs/sor_faq_CN.md
"sors": [
{
"baseAsset": "BTC",
"symbols": [
"BTCUSDT",
"BTCUSDC"
]
}
]
}

查询执行规则​

GET /api/v3/executionRules

查询交易对的执行规则。

权重:

参数权重
symbol2
symbols每个 symbol 占用 2,最多为 40
symbolStatus40
无40

参数:

名称类型是否必须描述
symbolSTRINGNO查询指定的交易对。
symbolsARRAY OF STRINGNO查询多个交易对。
symbolStatusENUMNO查询指定状态的所有交易对。

数据源: 缓存

注意: 不允许多个参数组合使用。

响应:

{
"symbolRules": [
{
"symbol": "BAZUSD",
"rules": [
{
"ruleType": "PRICE_RANGE",
"bidLimitMultUp": "1.0001",
"bidLimitMultDown": "0.9999",
"askLimitMultUp": "1.0001",
"askLimitMultDown": "0.9999"
}
]
}
]
}