Spot WebSocket API
string · 必须string · enum · 必须stringstring[]string[]booleanstring · enumstringinteger · int64stringinteger · int64stringstringinteger · int64integer · int64integer · int64
Properties for EXCHANGE_MAX_NUM_ORDERS:stringinteger · int64stringstringstringinteger · int64stringinteger · int64integer · int64integer · int64integer · int64string[]booleanbooleanbooleanbooleanbooleanbooleanbooleanbooleanbooleanbooleanboolean
Properties for PRICE_FILTER:stringintegerstringstringstringstring[]array[]stringstring[]stringstring[]
string · 必须string · enum · 必须stringstring[]string · enumstringinteger · int64stringstringstringstringstringstring
string · 必须string · enum · 必须objectstringinteger · int64objectstringstringinteger · int64integer · int64integer · int64
string · 必须string · enum · 必须objectstringinteger · int64integer · int64stringstringinteger · int64integer · int64integer · int64
交易规范信息
获取交易规则，速率限制，和交易对信息。
WSS
exchangeInfo
wss://ws-api.binance.com:443/ws-api/v3
交易规范信息 › 请求参数 可选
id客户端生成的请求标识符。
示例： 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
exchangeInfo
示例： exchangeInfo
object
symbol描述单个交易对
示例： BNBUSDT
symbols描述多个交易对
permissions按权限过滤交易对
showPermissionSets控制 permissionSets 字段的内容是否填充。默认为 true。
示例： true
默认值： true
symbolStatus过滤具有此 tradingStatus 的交易对。有效值：TRADING, HALT, BREAK。不能与 symbol 或 symbols 组合使用。
枚举值:
TRADING
HALT
BREAK
示例： TRADING
交易规范信息 › 响应
Successful Response
交易规范信息
id示例： 5494febb-d167-46a2-996d-70533eb4d976
status示例： 200
object
timezone示例： UTC
serverTime示例： 1655969291181
object[]
rateLimitType示例： REQUEST_WEIGHT
interval示例： MINUTE
intervalNum示例： 1
limit示例： 6000
count示例： 321
array
oneOf
Exactly one variant must match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · filterType="EXCHANGE_MAX_NUM_ORDERS" | |
| type = object · filterType="EXCHANGE_MAX_NUM_ALGO_ORDERS" | |
| type = object · filterType="EXCHANGE_MAX_NUM_ICEBERG_ORDERS" | |
| type = object · filterType="EXCHANGE_MAX_NUM_ORDER_LISTS" |
filterType示例： EXCHANGE_MAX_NUM_ORDERS
maxNumOrders示例： 1000
object[]
symbol示例： BNBBTC
status示例： TRADING
baseAsset示例： BNB
baseAssetPrecision示例： 8
quoteAsset示例： BTC
quotePrecision示例： 8
quoteAssetPrecision示例： 8
baseCommissionPrecision示例： 8
quoteCommissionPrecision示例： 8
orderTypesicebergAllowed示例： true
ocoAllowed示例： true
otoAllowed示例： true
opoAllowed示例： true
quoteOrderQtyMarketAllowed示例： true
allowTrailingStop示例： true
cancelReplaceAllowed示例： true
amendAllowed示例： false
pegInstructionsAllowed示例： true
isSpotTradingAllowed示例： true
isMarginTradingAllowed示例： true
array
oneOf
Exactly one variant must match.
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object · filterType="PRICE_FILTER" | |
| type = object · filterType="PERCENT_PRICE" | |
| type = object · filterType="PERCENT_PRICE_BY_SIDE" | |
| type = object · filterType="LOT_SIZE" | |
| type = object · filterType="MIN_NOTIONAL" | |
| type = object · filterType="NOTIONAL" | |
| type = object · filterType="ICEBERG_PARTS" | |
| type = object · filterType="MARKET_LOT_SIZE" | |
| type = object · filterType="MAX_NUM_ORDERS" | |
| type = object · filterType="MAX_NUM_ALGO_ORDERS" | |
| type = object · filterType="MAX_NUM_ICEBERG_ORDERS" | |
| type = object · filterType="MAX_POSITION" | |
| type = object · filterType="TRAILING_DELTA" | |
| type = object · filterType="T_PLUS_SELL" | |
| type = object · filterType="MAX_NUM_ORDER_LISTS" | |
| type = object · filterType="MAX_NUM_ORDER_AMENDS" |
filterType示例： PRICE_FILTER
priceExponent示例： 8
minPrice示例： 0.00000100
maxPrice示例： 100000.00000000
tickSize示例： 0.00000100
permissionspermissionSetsdefaultSelfTradePreventionMode示例： NONE
allowedSelfTradePreventionModesobject[]
baseAsset示例： BTC
symbols查询执行规则
查询交易对的执行规则。
WSS
executionRules
wss://ws-api.binance.com:443/ws-api/v3
查询执行规则 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
IP 权重
| Parameter | Weight |
|---|---|
symbol | 2 |
symbols | 2 for each symbol, capped at a max of 40 |
symbolStatus | 40 |
| None | 40 |
查询执行规则 › 请求参数 可选
id客户端生成的请求标识符。
示例： 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
executionRules
示例： executionRules
object
symbol查询指定的交易对。
示例： BAZUSD
symbols查询多个交易对。
symbolStatus查询指定状态的所有交易对。支持的值：TRADING, HALT, BREAK
枚举值:
TRADING
HALT
BREAK
示例： TRADING
查询执行规则 › 响应
Successful Response
查询执行规则
id示例： 5162affb-0aba-4821-b475-f2625006eb43
status示例： 200
object
object[]
symbol示例： BAZUSD
object[]
ruleType示例： PRICE_RANGE
bidLimitMultUp示例： 1.0001
bidLimitMultDown示例： 0.9999
askLimitMultUp示例： 1.0001
askLimitMultDown示例： 0.9999
测试连通性
测试能否联通 WebSocket API。
注意:
您也可以使用常规 WebSocket ping 帧来测试连通性，
WebSocket API 将尽快以 pong 帧响应。
ping 请求和 time 是在应用程序中测试请求-响应处理的安全方法。
WSS
ping
wss://ws-api.binance.com:443/ws-api/v3
测试连通性 › 请求参数 可选
id客户端生成的请求标识符。
示例： 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
ping
示例： ping
params测试连通性 › 响应
Successful Response
测试连通性
id示例： 922bcc6e-9de8-440d-9e84-7c80933a8d0d
status示例： 200
resultobject[]
rateLimitType示例： REQUEST_WEIGHT
interval示例： MINUTE
intervalNum示例： 1
limit示例： 6000
count示例： 321
检查服务器时间
测试与 WebSocket API 的连通性并获取当前服务器时间。
WSS
time
wss://ws-api.binance.com:443/ws-api/v3
检查服务器时间 › 请求参数 可选
id客户端生成的请求标识符。
示例： 7d3b9b46-5f4f-4c8b-9a2d-0a8f9a4a0f5b
methodWebSocket API 方法名称。
枚举值:
time
示例： time
params检查服务器时间 › 响应
Successful Response
检查服务器时间
id示例： 187d3cb2-942d-484c-8271-4e2141bbadb1
status示例： 200
object
serverTime示例： 1656400526260
object[]
rateLimitType示例： REQUEST_WEIGHT
interval示例： MINUTE
intervalNum示例： 1
limit示例： 6000
count示例： 321