常用请求信息

测试连通性

{
    "id": "922bcc6e-9de8-440d-9e84-7c80933a8d0d",
    "method": "ping"
}

测试能否联通 WebSocket API。

注意:

您也可以使用常规 WebSocket ping 帧来测试连通性， WebSocket API 将尽快以 pong 帧响应。 ping 请求和 time 是在应用程序中测试请求-响应处理的安全方法。

权重: 1

参数: NONE

数据源: 缓存

响应:

{
    "id": "922bcc6e-9de8-440d-9e84-7c80933a8d0d",
    "status": 200,
    "result": {},
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 1
        }
    ]
}

检查服务器时间

{
    "id": "187d3cb2-942d-484c-8271-4e2141bbadb1",
    "method": "time"
}

测试与 WebSocket API 的连通性并获取当前服务器时间。

权重: 1

参数: NONE

数据源: 缓存

响应:

{
    "id": "187d3cb2-942d-484c-8271-4e2141bbadb1",
    "status": 200,
    "result": {
        "serverTime": 1656400526260
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 1
        }
    ]
}

交易规范信息

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "exchangeInfo",
    "params": {
        "symbols": ["BNBBTC"]
    }
}

获取交易规则，速率限制，和交易对信息。

权重: 20

参数:

名称	类型	是否必需	描述
symbol	STRING	NO	代表单个交易对
symbols	ARRAY of STRING		代表多个交易对
permissions	ARRAY of STRING		按权限过滤交易对
showPermissionSets	BOOLEAN		控制是否返回 permissionSets 字段的内容，默认为 true
symbolStatus	ENUM		过滤具有此 tradingStatus 的交易对 有效值： TRADING， HALT， BREAK 不能与 symbol 或 symbols 组合使用

备注：

• 参数 symbol、symbols 和 permissions 不能相互组合使用。

• 如果没有参数，exchangeInfo 将显示具有 SPOT、MARGIN 或 LEVERAGED 权限的所有交易对。

  • 要显示具有任何权限的交易对，您需要在 permissions 中明确指定它们：（例如 ["SPOT","MARGIN",...])。有关完整列表，请参阅 可用权限。

解释响应中的 permissionSets：

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

数据源: 缓存

响应:

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "status": 200,
    "result": {
        "timezone": "UTC",
        "serverTime": 1655969291181,
        // 全局速率限制。请参阅 "速率限制" 部分。
        "rateLimits": [
            {
                "rateLimitType": "REQUEST_WEIGHT",     // 速率限制类型: REQUEST_WEIGHT，ORDERS，CONNECTIONS
                "interval": "MINUTE",                  // 速率限制间隔: SECOND，MINUTE，DAY
                "intervalNum": 1,                      // 速率限制间隔乘数 (i.e.，"1 minute")
                "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
            }
        ],
        // 交易所级别过滤器在 "过滤器" 页面上进行了说明：
        // https://github.com/binance/binance-spot-api-docs/blob/master/filters_CN.md
        // 全部交易过滤器是可选的。
        "exchangeFilters": [],
        "symbols": [
            {
                "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,
                // 交易对过滤器在"过滤器"页面上进行了说明：
                // https://github.com/binance/binance-spot-api-docs/blob/master/filters_CN.md
                // 全部交易对过滤器是可选的。
                "filters": [
                    {
                        "filterType": "PRICE_FILTER",
                        "minPrice": "0.00000100",
                        "maxPrice": "100000.00000000",
                        "tickSize": "0.00000100"
                    },
                    {
                        "filterType": "LOT_SIZE",
                        "minQty": "0.00100000",
                        "maxQty": "100000.00000000",
                        "stepSize": "0.00100000"
                    }
                ],
                "permissions": [],
                "permissionSets": [["SPOT", "MARGIN", "TRD_GRP_004"]],
                "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"]
            }
        ]
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

服务器关闭

{
  "event": {
    "e": "serverShutdown", // 事件类型
    "E": 1770123456789     // 事件时间
   }
}

当服务器即将关闭时，会发送 serverShutdown 事件。

请尽快重新连接 WebSocket API，以避免数据流中断。

查询执行规则

{
    "id": "5162affb-0aba-4821-b475-f2625006eb43",
    "method": "executionRules",
    "params": {
        "symbol": "BAZUSD"
    }
}

权重:

限制	权重
symbol	2
symbols	权重为 2，最多支持 40
symbolStatus	40
None	40

参数:

名称	类型	是否必须	描述
symbol	STRING	NO	查询指定的交易对
symbols	STRING	NO	查询多个交易对
symbolStatus	ENUM	NO	查询指定状态的所有交易对 支持的值：TRADING（正常交易中）、HALT（交易终止）、BREAK（交易暂停)

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

数据来源： 缓存

响应示例：

{
  "id": "5162affb-0aba-4821-b475-f2625006eb43",
  "status": 200,
  "result": {
    "symbolRules": [
      {
        "symbol": "BAZUSD",
        "rules": [
          {
            "ruleType": "PRICE_RANGE",
            "bidLimitMultUp": "1.0001",
            "bidLimitMultDown": "0.9999",
            "askLimitMultUp": "1.0001",
            "askLimitMultDown": "0.9999"
          }
        ]
      }
    ]
  }
}