跳到主要内容

账户请求

账户信息 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "account.status",
    "params": {
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

获取当前账户信息。

权重: 20

参数:

名称类型是否必须描述
apiKeySTRINGYES
omitZeroBalancesBOOLEANNO如果true，将隐藏所有零余额。默认值：false。
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存 => 数据库

响应:

{
    "id": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
    "status": 200,
    "result": {
        "makerCommission": 15,
        "takerCommission": 15,
        "buyerCommission": 0,
        "sellerCommission": 0,
        "canTrade": true,
        "canWithdraw": true,
        "canDeposit": true,
        "commissionRates": {
            "maker": "0.00150000",
            "taker": "0.00150000",
            "buyer": "0.00000000",
            "seller": "0.00000000"
        },
        "brokered": false,
        "requireSelfTradePrevention": false,
        "preventSor": false,
        "updateTime": 1660801833000,
        "accountType": "SPOT",
        "balances": [
            {
                "asset": "BNB",
                "free": "0.00000000",
                "locked": "0.00000000"
            },
            {
                "asset": "BTC",
                "free": "1.3447112",
                "locked": "0.08600000"
            },
            {
                "asset": "USDT",
                "free": "1021.21000000",
                "locked": "0.00000000"
            }
        ],
        "permissions": [
            "SPOT"
        ],
        "uid": 354937868
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

查询订单 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "order.status",
    "params": {
        "symbol": "BTCUSDT",
        "orderId": 12569099453,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88",
        "timestamp": 1660801715431
    }
}

查询订单状态。

权重: 4

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
orderIdLONGNO按 orderId 查找订单
origClientOrderIdSTRINGNO按 clientOrderId 查找订单
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存 => 数据库

备注：

  • 当同时提供 orderId 和 origClientOrderId 两个参数时，系统首先将会使用 orderId 来搜索订单。然后， 查找结果中的 origClientOrderId 的值将会被用来验证订单。如果两个条件都不满足，则请求将被拒绝。

  • 对于某些历史订单，cummulativeQuoteQty 响应字段可能为负数，意味着此时数据不可用。

响应:

{
    "id": "aa62318a-5a97-4f3b-bdc7-640bbe33b291",
    "status": 200,
    "result": {
        "symbol": "BTCUSDT",
        "orderId": 12569099453,
        "orderListId": -1,                       // 仅当订单属于订单列表时返回。
        "clientOrderId": "4d96324ff9d44481926157",
        "price": "23416.10000000",
        "origQty": "0.00847000",
        "executedQty": "0.00847000",
        "origQuoteOrderQty": "0.000000",         // 始终返回；若订单类型不使用 `quoteOrderQty` 则为 0。
        "cummulativeQuoteQty": "198.33521500",
        "status": "FILLED",
        "timeInForce": "GTC",
        "type": "LIMIT",
        "side": "SELL",
        "stopPrice": "0.00000000",               // 始终返回；若订单类型不使用 `stopPrice` 则为 0。
        "trailingDelta": 10,                     // 仅当订单设置了 `trailingDelta` 时返回。
        "trailingTime": -1,                      // 仅当订单设置了 `trailingDelta` 时返回。
        "icebergQty": "0.00000000",              // 始终返回；非冰山订单为 0。
        "time": 1660801715639,                   // 下单时间。
        "updateTime": 1660801717945,             // 订单最后更新时间。
        "isWorking": true,
        "workingTime": 1660801715639,
        "strategyId": 37463720,                  // 仅当订单设置了 `strategyId` 时返回。
        "strategyType": 1000000,                 // 仅当订单设置了 `strategyType` 时返回。
        "selfTradePreventionMode": "NONE",
        "preventedMatchId": 0,                   // 仅当订单因 STP 过期时返回。
        "preventedQuantity": "1.200000",         // 仅当订单因 STP 过期时返回。
        "usedSor": true,                         // 用于确定订单是否使用SOR的字段。
        "workingFloor": "SOR",                   // 用以定义订单是通过 SOR 还是由订单簿成交的。
        "pegPriceType": "PRIMARY_PEG",           // 挂钩价格类型。仅用于挂钩订单。
        "pegOffsetType": "PRICE_LEVEL",          // 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
        "pegOffsetValue": 5,                     // 挂钩价格偏移值。如若需要，仅用于挂钩订单。
        "peggedPrice": "87523.83710000",         // 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
        "expiryReason": "INSUFFICIENT_LIQUIDITY" // 订单过期的原因。当订单过期时出现。
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

注意: 上面的 payload 没有显示所有可以出现的字段，更多请看 订单响应中的特定条件时才会出现的字段 部分。

当前挂单 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "openOrders.status",
    "params": {
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

查询所有挂订单的执行状态。

如果您需要持续监控订单状态更新，请考虑使用 WebSocket Streams：

权重:

参数权重
symbol6
不提供80

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGNO如果省略，则返回所有交易对的挂单
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存 => 数据库

响应:

{
    "id": "55f07876-4f6f-4c47-87dc-43e5fff3f2e7",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "orderId": 12569099453,
            "orderListId": -1,                       // 仅当订单属于订单列表时返回。
            "clientOrderId": "4d96324ff9d44481926157",
            "price": "23416.10000000",
            "origQty": "0.00847000",
            "executedQty": "0.00720000",
            "origQuoteOrderQty": "0.000000",         // 始终返回；若订单类型不使用 `quoteOrderQty` 则为 0。
            "cummulativeQuoteQty": "172.43931000",
            "status": "PARTIALLY_FILLED",
            "timeInForce": "GTC",
            "type": "LIMIT",
            "side": "SELL",
            "time": 1660801715639,                   // 下单时间。
            "updateTime": 1660801717945,             // 订单最后更新时间。
            "isWorking": true,
            "workingTime": 1660801715639,
            "selfTradePreventionMode": "NONE",
            "icebergQty": "0.00000000",              // 仅在请求中发送了 icebergQty 参数时出现。
            "preventedMatchId": 0,                   // 仅在因 STP 导致订单失效时出现。
            "preventedQuantity": "1.200000",         // 因 STP 导致订单失效的数量。
            "stopPrice": "0.00000000",               // 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
            "strategyId": 1,                         // 仅在下单时提供了 strategyId 参数时出现。
            "strategyType": 1000000,                 // 仅在下单时提供了 strategyType 参数时出现。
            "trailingDelta": 10,                     // 订单激活前所需的价格变动。
            "trailingTime": -1,                      // 追踪单被激活和跟踪价格变化的时间。
            "usedSor": true,                         // 用于确定订单是否使用SOR的字段。
            "workingFloor": "SOR",                   // 用以定义订单是通过 SOR 还是由订单簿成交的。
            "pegPriceType": "PRIMARY_PEG",           // 挂钩价格类型。仅用于挂钩订单。
            "pegOffsetType": "PRICE_LEVEL",          // 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
            "pegOffsetValue": 5,                     // 挂钩价格偏移值。如若需要，仅用于挂钩订单。
            "peggedPrice": "87523.83710000",         // 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
            "expiryReason": "INSUFFICIENT_LIQUIDITY" // 订单过期的原因。当订单过期时出现。
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 6
        }
    ]
}

注意: 上面的 payload 没有显示所有可以出现的字段，更多请看 订单响应中的特定条件时才会出现的字段 部分。

账户订单历史 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "allOrders",
    "params": {
        "symbol": "BNBUSDT",
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

查询所有订单（活动、已撤销、已成交）信息，并按时间范围过滤。

权重: 20

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
orderIdLONGNO起始订单ID
startTimeLONGNO毫秒时间戳
endTimeLONGNO毫秒时间戳
limitINTNO默认值: 500; 最大值: 1000
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

备注：

  • 如果指定了 startTime 和/或 endTime，则忽略 orderId。

    订单是按照最后一次更新的执行状态的time过滤的。

  • 如果指定了 orderId，返回的订单将是订单ID >= orderId

  • 如果不指定条件，则返回最近的订单。

  • 对于某些历史订单，cummulativeQuoteQty 响应字段可能为负数，代表着此时数据还不可用。

  • startTime和endTime之间的时间不能超过 24 小时。

响应:

{
    "id": "734235c2-13d2-4574-be68-723e818c08f3",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "orderId": 12569099453,
            "orderListId": -1,                       // 仅当订单属于订单列表时返回。
            "clientOrderId": "4d96324ff9d44481926157",
            "price": "23416.10000000",
            "origQty": "0.00847000",
            "executedQty": "0.00847000",
            "cummulativeQuoteQty": "198.33521500",
            "status": "FILLED",
            "timeInForce": "GTC",
            "type": "LIMIT",
            "side": "SELL",
            "time": 1660801715639,                   // 下单时间。
            "updateTime": 1660801717945,             // 订单最后更新时间。
            "isWorking": true,
            "workingTime": 1660801715639,
            "origQuoteOrderQty": "0.000000",         // 始终返回；若订单类型不使用 `quoteOrderQty` 则为 0。
            "selfTradePreventionMode": "NONE",
            "preventedMatchId": 0,                   // 仅当订单因 STP 过期时返回。
            "preventedQuantity": "1.200000",         // 仅当订单因 STP 过期时返回。
            "icebergQty": "0.00000000",              // 仅在请求中发送了 icebergQty 参数时出现。
            "stopPrice": "0.00000000",               // 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
            "strategyId": 1,                         // 仅在下单时提供了 strategyId 参数时出现。
            "strategyType": 1000000,                 // 仅在下单时提供了 strategyType 参数时出现。
            "trailingDelta": 10,                     // 订单激活前所需的价格变动。
            "trailingTime": -1,                      // 追踪单被激活和跟踪价格变化的时间。
            "usedSor": true,                         // 用于确定订单是否使用SOR的字段。
            "workingFloor": "SOR",                   // 用以定义订单是通过 SOR 还是由订单簿成交的。
            "pegPriceType": "PRIMARY_PEG",           // 挂钩价格类型。仅用于挂钩订单。
            "pegOffsetType": "PRICE_LEVEL",          // 挂钩价格偏移类型。如若需要，仅用于挂钩订单。
            "pegOffsetValue": 5,                     // 挂钩价格偏移值。如若需要，仅用于挂钩订单。
            "peggedPrice": "87523.83710000",         // 订单对应的当前挂钩价格。一旦确定，仅用于挂钩订单。
            "expiryReason": "INSUFFICIENT_LIQUIDITY" // 订单过期的原因。当订单过期时出现。
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

查询订单列表 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "orderList.status",
    "params": {
        "origClientOrderId": "08985fedd9ea2cf6b28996",
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88",
        "timestamp": 1660801715431
    }
}

检查订单列表的执行状态。

对于单个订单的执行状态，使用 order.status。

权重: 4

参数:

名称类型是否必须描述
apiKeySTRINGYES
origClientOrderIdSTRINGNO通过 listClientOrderId 获取订单列表。必须提供 orderListId 或 origClientOrderId。
orderListIdINTNO通过 orderListId 获取订单列表。必须提供 orderListId 或 origClientOrderId。
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

备注：

  • origClientOrderId 指的是订单列表本身的 listClientOrderId。

  • 如果同时指定了 origClientOrderId 和 orderListId 参数，仅使用 origClientOrderId 并忽略 orderListId。

响应:

{
    "id": "b53fd5ff-82c7-4a04-bd64-5f9dc42c2100",
    "status": 200,
    "result": {
        "orderListId": 1274512,
        "contingencyType": "OCO",
        "listStatusType": "EXEC_STARTED",
        "listOrderStatus": "EXECUTING",
        "listClientOrderId": "08985fedd9ea2cf6b28996",
        "transactionTime": 1660801713793,
        "symbol": "BTCUSDT",
        "orders": [
            {
                "symbol": "BTCUSDT",
                "orderId": 12569138901,
                "clientOrderId": "BqtFCj5odMoWtSqGk2X9tU"
            },
            {
                "symbol": "BTCUSDT",
                "orderId": 12569138902,
                "clientOrderId": "jLnZpj5enfMXTuhKB1d0us"
            }
        ]
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

查询订单列表挂单 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "openOrderLists.status",
    "params": {
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

查询所有订单列表挂单的执行状态。

如果您需要持续监控订单状态更新，请考虑使用 WebSocket Streams：

权重: 6

参数:

名称类型是否必须描述
apiKeySTRINGYES
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存 => 数据库

响应:

{
    "id": "3a4437e2-41a3-4c19-897c-9cadc5dce8b6",
    "status": 200,
    "result": [
        {
            "orderListId": 0,
            "contingencyType": "OCO",
            "listStatusType": "EXEC_STARTED",
            "listOrderStatus": "EXECUTING",
            "listClientOrderId": "08985fedd9ea2cf6b28996",
            "transactionTime": 1660801713793,
            "symbol": "BTCUSDT",
            "orders": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": 4,
                    "clientOrderId": "CUhLgTXnX5n2c0gWiLpV4d"
                },
                {
                    "symbol": "BTCUSDT",
                    "orderId": 5,
                    "clientOrderId": "1ZqG7bBuYwaF4SU8CwnwHm"
                }
            ]
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 6
        }
    ]
}

账户订单列表历史 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "allOrderLists",
    "params": {
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

查询所有订单列表的信息，按时间范围过滤。

权重: 20

参数:

名称类型是否必须描述
apiKeySTRINGYES
fromIdINTNO起始的 Order list ID
startTimeLONGNO毫秒时间戳
endTimeLONGNO毫秒时间戳
limitINTNO默认值: 500; 最大值: 1000
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

备注：

  • 如果指定了 startTime 和/或 endTime，则忽略 fromId。

    订单列表是按照最后一次更新的订单列表执行状态的 transactionTime 过滤的。

  • 如果指定了 fromId，返回的订单列表将是 order list ID >= fromId。

  • 如果不指定条件，则返回最近的订单列表。

  • startTime和endTime之间的时间不能超过 24 小时

响应:

{
    "id": "8617b7b3-1b3d-4dec-94cd-eefd929b8ceb",
    "status": 200,
    "result": [
        {
            "orderListId": 1274512,
            "contingencyType": "OCO",
            "listStatusType": "EXEC_STARTED",
            "listOrderStatus": "EXECUTING",
            "listClientOrderId": "08985fedd9ea2cf6b28996",
            "transactionTime": 1660801713793,
            "symbol": "BTCUSDT",
            "orders": [
                {
                    "symbol": "BTCUSDT",
                    "orderId": 12569138901,
                    "clientOrderId": "BqtFCj5odMoWtSqGk2X9tU"
                },
                {
                    "symbol": "BTCUSDT",
                    "orderId": 12569138902,
                    "clientOrderId": "jLnZpj5enfMXTuhKB1d0us"
                }
            ]
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

账户成交历史 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "myTrades",
    "params": {
        "symbol": "BNBUSDT",
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

获取账户指定交易对的成交历史，按时间范围过滤。

权重:

条件权重
没有 orderId20
有 orderId5

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
orderIdLONGNO必须要和参数symbol一起使用。
startTimeLONGNO毫秒时间戳
endTimeLONGNO毫秒时间戳
fromIdINTNO起始交易 ID
limitINTNO默认值: 500; 最大值: 1000
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存 => 数据库

说明：

  • 指定 fromId 时，返回 trade ID >= fromId 的成交记录。
  • 指定 startTime 和/或 endTime 时，按执行时间（time）过滤。
  • fromId 不能与 startTime、endTime 同时使用。
  • 指定 orderId 时，仅返回该订单相关成交。
  • startTime、endTime 不能与 orderId 同时使用。
  • 未指定条件时，返回最近成交记录。
  • startTime 与 endTime 间隔不能超过 24 小时。

响应:

{
    "id": "f4ce6a53-a29d-4f70-823b-4ab59391d6e8",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "id": 1650422481,
            "orderId": 12569099453,
            "orderListId": -1,
            "price": "23416.10000000",
            "qty": "0.00635000",
            "quoteQty": "148.69223500",
            "commission": "0.00000000",
            "commissionAsset": "BNB",
            "time": 1660801715793,
            "isBuyer": false,
            "isMaker": true,
            "isBestMatch": true
        },
        {
            "symbol": "BTCUSDT",
            "id": 1650422482,
            "orderId": 12569099453,
            "orderListId": -1,
            "price": "23416.50000000",
            "qty": "0.00212000",
            "quoteQty": "49.64298000",
            "commission": "0.00000000",
            "commissionAsset": "BNB",
            "time": 1660801715793,
            "isBuyer": false,
            "isMaker": true,
            "isBestMatch": true
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

查询未成交的订单计数 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "account.rateLimits.orders",
    "params": {
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

显示用户在所有时间间隔内的未成交订单计数。

权重: 40

参数:

名称类型是否必须描述
apiKeySTRINGYES
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存

响应:

{
    "id": "d3783d8d-f8d1-4d2c-b8a0-b7596af5a664",
    "status": 200,
    "result": [
        {
            "rateLimitType": "ORDERS",
            "interval": "SECOND",
            "intervalNum": 10,
            "limit": 50,
            "count": 0
        },
        {
            "rateLimitType": "ORDERS",
            "interval": "DAY",
            "intervalNum": 1,
            "limit": 160000,
            "count": 0
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 40
        }
    ]
}

账户的 Prevented Matches (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "myPreventedMatches",
    "params": {
        "symbol": "BTCUSDT",
        "orderId": 35,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88",
        "timestamp": 1660801715431
    }
}

获取因 STP 而过期的订单列表。

这些是支持的组合：

  • symbol + preventedMatchId
  • symbol + orderId
  • symbol + orderId + fromPreventedMatchId (limit 默认为 500)
  • symbol + orderId + fromPreventedMatchId + limit

权重:

情况权重
如果 symbol 不合法2
通过 preventedMatchId 查询2
通过 orderId 查询20

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
preventedMatchIdLONGNOPrevented match ID
orderIdLONGNO订单 ID
fromPreventedMatchIdLONGNO起始 prevented match ID
limitINTNO默认值: 500; 最大值: 1000
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

响应:

{
    "id": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "preventedMatchId": 1,
            "takerOrderId": 5,
            "makerSymbol": "BTCUSDT",
            "makerOrderId": 3,
            "tradeGroupId": 1,
            "selfTradePreventionMode": "EXPIRE_MAKER",
            "price": "1.100000",
            "makerPreventedQuantity": "1.300000",
            "transactTime": 1669101687094
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

查询分配结果 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "myAllocations",
    "params": {
        "symbol": "BTCUSDT",
        "orderId": 500,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88",
        "timestamp": 1660801715431
    }
}

检索由 SOR 订单生成引起的分配结果。

权重: 20

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
startTimeLONGNO毫秒时间戳
endTimeLONGNO毫秒时间戳
fromAllocationIdINTNO起始分配 ID
limitINTNO默认值: 500; 最大值: 1000
orderIdLONGNO订单 ID
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGNO用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

支持的参数组合:

参数响应
symbol按从最旧到最新排序的分配
symbol + startTime从 startTime 开始的最旧的分配
symbol + endTime到 endTime 为止的最新的分配
symbol + startTime + endTime在指定时间范围内的分配
symbol + fromAllocationId从指定 AllocationId 开始的分配
symbol + orderId按从最旧到最新排序并和特定订单关联的分配
symbol + orderId + fromAllocationId从指定 AllocationId 开始并和特定订单关联的分配

注意: startTime 和 endTime 之间的时间不能超过 24 小时。

响应:

{
    "id": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "allocationId": 0,
            "allocationType": "SOR",
            "orderId": 500,
            "orderListId": -1,
            "price": "1.00000000",
            "qty": "0.10000000",
            "quoteQty": "0.10000000",
            "commission": "0.00000000",
            "commissionAsset": "BTC",
            "time": 1687319487614,
            "isBuyer": false,
            "isMaker": false,
            "isAllocator": false
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

账户佣金费率 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "account.commission",
    "params": {
        "symbol": "BNBUSDT",
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

获取当前账户的佣金费率。

权重: 20

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

响应:

{
    "id": "d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0",
    "status": 200,
    "result": {
        "symbol": "BTCUSDT",
        // 订单成交的标准佣金率。
        "standardCommission": {
            "maker": "0.00000010",
            "taker": "0.00000020",
            "buyer": "0.00000030",
            "seller": "0.00000040"
        },
        // 订单成交的特殊佣金率。
        "specialCommission": {
            "maker": "0.01000000",
            "taker": "0.02000000",
            "buyer": "0.03000000",
            "seller": "0.04000000"
        },
        // 订单成交的税费率。
        "taxCommission": {
            "maker": "0.00000112",
            "taker": "0.00000114",
            "buyer": "0.00000118",
            "seller": "0.00000116"
        },
        // 使用 BNB 支付时的标准佣金折扣信息。
        "discount": {
            "enabledForAccount": true,
            "enabledForSymbol": true,
            "discountAsset": "BNB",
            "discount": "0.75000000" // 当用BNB支付佣金时，在标准佣金上按此比率打折。
        }
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

查询改单 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "order.amendments",
    "params": {
        "symbol": "BNBUSDT",
        "orderId": 1,
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

查询对一个订单的所有改单操作。

权重: 4

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
orderIdLONGYES订单 ID
fromExecutionIdLONGNO起始执行 ID
limitLONGNO默认值: 500; 最大值: 1000
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 数据库

响应:

{
    "id": "6f5ebe91-01d9-43ac-be99-57cf062e0e30",
    "status": 200,
    "result": [
        {
            "symbol": "BTCUSDT",
            "orderId": 23,
            "executionId": 60,
            "origClientOrderId": "my_pending_order",
            "newClientOrderId": "xbxXh5SSwaHS7oUEOCI88B",
            "origQty": "7.00000000",
            "newQty": "5.00000000",
            "time": 1741924229819
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

查询相关过滤器 (USER_DATA)​

{
    "id": "5494febb-d167-46a2-996d-70533eb4d976",
    "method": "myFilters",
    "params": {
        "symbol": "BNBUSDT",
        "timestamp": 1770736694138,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "15af09e41c36f3cc61378c2fbe2c33719a03dd5eba8d0f9206fbda44de717c88"
    }
}

用于检索一个账户上指定交易对的 filters 列表。这是唯一一个目前会显示账户是否应用了 MAX_ASSET 过滤器的方法。

权重: 40

参数:

名称类型是否必须描述
apiKeySTRINGYES
symbolSTRINGYES
recvWindowDECIMALNO最大值： 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES用于请求签名的 Unix 时间戳，单位为毫秒或微秒。该值必须反映客户端当前时间，并会在签名接口中由服务器进行校验。
signatureSTRINGYES

数据源: 缓存

响应:

{
    "id": "1758009606869",
    "status": 200,
    "result": {
        "exchangeFilters": [
            {
                "filterType": "EXCHANGE_MAX_NUM_ORDERS",
                "maxNumOrders": 1000
            }
        ],
        "symbolFilters": [
            {
                "filterType": "PRICE_FILTER",
                "minPrice": "0.00000100",
                "maxPrice": "100000.00000000",
                "tickSize": "0.00000100"
            }
        ],
        "assetFilters": [
            {
                "filterType": "MAX_ASSET",
                "limit": "1000000.00000000",
                "asset": "JPY"
            }
        ],
        "rateLimits": [
            {
                "rateLimitType": "REQUEST_WEIGHT",
                "interval": "MINUTE",
                "intervalNum": 1,
                "limit": 6000,
                "count": 40
            }
        ]
    }
}