常用请求信息

术语

这些术语将在整个文档中使用，因此特别建议新用户阅读。

base asset 是指作为交易对中的 quantity 资产。对于交易对 BTCUSDT，BTC 将是 base asset。
quote asset 是指作为交易对中的 price 资产。对于交易对 BTCUSDT，USDT 将是 quote asset。

测试连通性

{
  "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,
        "quoteOrderQtyMarketAllowed": true,
        "allowTrailingStop": true,
        "cancelReplaceAllowed": 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
    }
  ]
}

术语​

测试连通性​

检查服务器时间​

交易规范信息​

术语

测试连通性

检查服务器时间

交易规范信息