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[]stringstringinteger · int64integer · int64integer · int64
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},{"rateLimitType":"ORDERS","interval":"SECOND","intervalNum":10,"limit":50},{"rateLimitType":"ORDERS","interval":"DAY","intervalNum":1,"limit":160000},{"rateLimitType":"CONNECTIONS","interval":"MINUTE","intervalNum":5,"limit":300}]
rateLimitType示例： REQUEST_WEIGHT
interval示例： MINUTE
intervalNum示例： 1
limit示例： 6000
count示例： 40
array
交易所级别过滤器在 "过滤器" 页面上进行了说明： /products/spot/filters.md 全部交易过滤器是可选的。
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
orderTypes示例： ["LIMIT","LIMIT_MAKER","MARKET","STOP_LOSS_LIMIT","TAKE_PROFIT_LIMIT"]
icebergAllowed示例： true
ocoAllowed示例： true
otoAllowed示例： true
opoAllowed示例： true
quoteOrderQtyMarketAllowed示例： true
allowTrailingStop示例： true
cancelReplaceAllowed示例： true
amendAllowed示例： false
pegInstructionsAllowed示例： true
isSpotTradingAllowed示例： true
isMarginTradingAllowed示例： true
array
交易对过滤器在"过滤器"页面上进行了说明： /products/spot/filters.md 全部交易对过滤器是可选的。
示例： [{"filterType":"PRICE_FILTER","minPrice":"0.00000100","maxPrice":"100000.00000000","tickSize":"0.00000100"},{"filterType":"LOT_SIZE","minQty":"0.00100000","maxQty":"100000.00000000","stepSize":"0.00100000"}]
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[]
可选字段，仅当 SOR 可用时才会被显示出来。 /products/spot/faqs/sor_faq.md
baseAsset示例： BTC
symbols示例： ["BTCUSDT","BTCUSDC"]
object[]
rateLimitType示例： REQUEST_WEIGHT
interval示例： MINUTE
intervalNum示例： 1
limit示例： 6000
count示例： 20
查询执行规则
查询交易对的执行规则。
WSS
executionRules
wss://ws-api.binance.com:443/ws-api/v3
查询执行规则 › 请求权重
此端点消耗基于IP的请求权重。较重的端点会消耗更多您的IP速率限制容量。
请在限速说明章节中了解更多信息。
IP 权重
| 参数 | 权重 |
|---|---|
symbol | 2 |
symbols | 每个 symbol 占用 2，最多为 40 |
symbolStatus | 40 |
| 无 | 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示例： 1
检查服务器时间
测试与 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示例： 1