常用请求信息

测试连通性

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "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": "5494febb-d167-46a2-996d-70533eb4d976",
    "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"
}

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

权重: 20

参数:

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

数据源: 缓存

备注:

如果参数 symbol 或者 symbols 提供的交易对不存在, 系统会返回错误并提示交易对不正确。
所有的参数都是可选的。
symbol、symbols、permissions 参数只能指定其中一个。
不带参数时, exchangeInfo 显示所有具有 ["SPOT", "MARGIN", "LEVERAGED"] 权限的交易对。
- 要列出交易所上所有活跃的交易对, 您需要在 permissions 中明确指定它们。
permissions 可以支持单个或多个值（例如 "SPOT", ["MARGIN","LEVERAGED"]）。

解释响应中的 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": [
            {
                "filterType": "EXCHANGE_MAX_NUM_ORDERS",
                "maxNumOrders": 1000
            }
        ],
        "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": [
                    "SPOT"
                ],
                "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
        }
    ]
}

查询执行规则

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "executionRules"
}

查询交易对的执行规则。

权重:

参数	权重
`symbol`	2
`symbols`	每个 `symbol` 占用 2，最多为 40
`symbolStatus`	40
无	40

参数:

名称	类型	是否必须	描述
`symbol`	STRING	NO	查询指定的交易对。
`symbols`	ARRAY OF 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"
                    }
                ]
            }
        ]
    }
}

测试连通性​

检查服务器时间​

交易规范信息​

查询执行规则​

测试连通性

检查服务器时间

交易规范信息

查询执行规则