通用接口
测试服务器连通性 PING
GET /api/v3/ping
测试能否联通
权重: 1
参数: NONE
数据源: 缓存
响应:
{}
获取服务器时间
GET /api/v3/time
权重: 1
参数: NONE
数据源: 缓存
响应:
{
"serverTime": 1499827319559
}
交易规范信息
GET /api/v3/exchangeInfo
获取此时的交易规范信息
权重: 20
参数:
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | NO | 示例:curl -X GET "https://api.binance.com/api/v3/exchangeInfo?symbol=BNBBTC" |
| symbols | ARRAY OF STRING | NO | 示例: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"]' |
| permissions | ENUM | NO | 示例: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"]' |
| showPermissionSets | BOOLEAN | NO | 默认值: true。 用于控制是否提供 permissionSets 字段的内容。 |
| symbolStatus | ENUM | NO | 用于过滤具有此 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