跳到主要内容

账户请求

账户信息 (USER_DATA)​

{
    "id": "605a6d20-6588-4cb9-afa0-b0ab087507ba",
    "method": "account.status",
    "params": {
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "83303b4a136ac1371795f465808367242685a9e3a42b22edb4d977d0696eb45c",
        "timestamp": 1660801839480
    }
}

获取当前账户信息。

权重: 20

参数:

名称类型是否必需描述
apiKeySTRINGYES
omitZeroBalancesBOOLEANNO如果true，将隐藏所有零余额。
默认值：false。
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

数据源: 缓存 => 数据库

响应:

{
    "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": "aa62318a-5a97-4f3b-bdc7-640bbe33b291",
    "method": "order.status",
    "params": {
        "symbol": "BTCUSDT",
        "orderId": 12569099453,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "2c3aab5a078ee4ea465ecd95523b77289f61476c2f238ec10c55ea6cb11a6f35",
        "timestamp": 1660801720951
    }
}

查询订单状态。

权重: 4

参数:

名称 类型 是否必需 描述
symbol STRING YES
orderId LONG YES 按 orderId 查找顺序
origClientOrderId STRING 按 clientOrderId 查找顺序
apiKey STRING YES
recvWindow DECIMAL NO 值不能大于 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signature STRING YES
timestamp LONG YES

备注：

  • 当同时提供 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",
        "cummulativeQuoteQty": "198.33521500",
        "status": "FILLED",
        "timeInForce": "GTC",
        "type": "LIMIT",
        "side": "SELL",
        "stopPrice": "0.00000000",             // 始终存在，如果订单类型不使用 stopPrice，则为零
        "trailingDelta": 10,                   // 如果订单设置了 trailingDelta 会出现
        "trailingTime": -1,                    // 如果订单设置了 trailingDelta 会出现
        "icebergQty": "0.00000000",            // 始终存在，非冰山订单为零
        "time": 1660801715639,                 // 下单时间
        "updateTime": 1660801717945,           // 最后一次更新订单的时间
        "isWorking": true,
        "workingTime": 1660801715639,
        "origQuoteOrderQty": "0.00000000",     // 始终存在，如果订单类型不使用 quoteOrderQty，则为零
        "strategyId": 37463720,                // 如果订单设置了 strategyId  会出现
        "strategyType": 1000000,               // 如果订单设置了 strategyType 会出现
        "selfTradePreventionMode": "NONE",
        "preventedMatchId": 0,                 // 这仅在订单因 STP 而过期时可见
        "preventedQuantity": "1.200000"        // 这仅在订单因 STP 而过期时可见
    },
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 4
        }
    ]
}

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

当前挂单 (USER_DATA)​

{
    "id": "55f07876-4f6f-4c47-87dc-43e5fff3f2e7",
    "method": "openOrders.status",
    "params": {
        "symbol": "BTCUSDT",
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "d632b3fdb8a81dd44f82c7c901833309dd714fe508772a89b0a35b0ee0c48b89",
        "timestamp": 1660813156812
    }
}

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

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

权重: 根据交易对的数量进行调整：

参数权重
symbol6
none80

参数:

名称类型是否必需描述
symbolSTRINGNO如果省略，则返回所有交易对的挂单
apiKeySTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

数据源: 缓存 => 数据库

响应:

挂单的状态报告与 order.status 相同。

请注意，某些字段是可选的，仅在订单中有设置它们时才包括。

挂订单始终作为平面列表返回。 如果所有交易对被请求，请使用 symbol 字段来告知订单属于哪个交易对。

{
    "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",
            "cummulativeQuoteQty": "172.43931000",
            "status": "PARTIALLY_FILLED",
            "timeInForce": "GTC",
            "type": "LIMIT",
            "side": "SELL",
            "stopPrice": "0.00000000",
            "icebergQty": "0.00000000",
            "time": 1660801715639,
            "updateTime": 1660801717945,
            "isWorking": true,
            "workingTime": 1660801715639,
            "origQuoteOrderQty": "0.00000000",
            "selfTradePreventionMode": "NONE"
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 6
        }
    ]
}

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

账户订单历史 (USER_DATA)​

{
    "id": "734235c2-13d2-4574-be68-723e818c08f3",
    "method": "allOrders",
    "params": {
        "symbol": "BTCUSDT",
        "startTime": 1660780800000,
        "endTime": 1660867200000,
        "limit": 5,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "f50a972ba7fad92842187643f6b930802d4e20bce1ba1e788e856e811577bd42",
        "timestamp": 1661955123341
    }
}

获取所有账户订单； 有效，已取消或已完成。按时间范围过滤。

权重: 20

参数:

名称类型是否必需描述
symbolSTRINGYES
orderIdLONGNO起始订单ID
startTimeLONGNO
endTimeLONGNO
limitINTNO默认值： 500； 最大值： 1000
apiKeySTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

备注：

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

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

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

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

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

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

数据源: 数据库

响应:

订单状态报告与 order.status 相同。

请注意，某些字段是可选的，仅在订单中有设置它们时才包括。

{
    "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",
            "stopPrice": "0.00000000",
            "icebergQty": "0.00000000",
            "time": 1660801715639,
            "updateTime": 1660801717945,
            "isWorking": true,
            "origQuoteOrderQty": "0.00000000",
            "selfTradePreventionMode": "NONE",
            "preventedMatchId": 0,              // 这仅在订单因 STP 而过期时可见
            "preventedQuantity": "1.200000"     // 这仅在订单因 STP 而过期时可见
        }
    ],
    "rateLimits": [
        {
            "rateLimitType": "REQUEST_WEIGHT",
            "interval": "MINUTE",
            "intervalNum": 1,
            "limit": 6000,
            "count": 20
        }
    ]
}

查询订单列表 (USER_DATA)​

{
    "id": "b53fd5ff-82c7-4a04-bd64-5f9dc42c2100",
    "method": "orderList.status",
    "params": {
        "origClientOrderId": "08985fedd9ea2cf6b28996",
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "d12f4e8892d46c0ddfbd43d556ff6d818581b3be22a02810c2c20cb719aed6a4",
        "timestamp": 1660801713965
    }
}

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

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

权重: 4

Parameters:

名称 类型 是否必需 描述
origClientOrderId STRING NO* 通过 listClientOrderId 获取订单列表。
必须提供 orderListId 或 origClientOrderId。
orderListId INT 通过 orderListId 获取订单列表。
必须提供 orderListId 或 origClientOrderId。
apiKey STRING YES
recvWindow DECIMAL NO 值不能大于 60000。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signature STRING YES
timestamp LONG YES

备注：

  • 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": "3a4437e2-41a3-4c19-897c-9cadc5dce8b6",
    "method": "openOrderLists.status",
    "params": {
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "1bea8b157dd78c3da30359bddcd999e4049749fe50b828e620e12f64e8b433c9",
        "timestamp": 1660801713831
    }
}

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

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

权重: 6

参数:

名称类型是否必需描述
apiKeySTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

数据源: 数据库

响应:

{
    "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": "8617b7b3-1b3d-4dec-94cd-eefd929b8ceb",
    "method": "allOrderLists",
    "params": {
        "startTime": 1660780800000,
        "endTime": 1660867200000,
        "limit": 5,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "c8e1484db4a4a02d0e84dfa627eb9b8298f07ebf12fcc4eaf86e4a565b2712c2",
        "timestamp": 1661955123341
    }
}

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

权重: 20

参数:

名称类型是否必需描述
fromIdINTNO起始的 Order list ID
startTimeLONGNO
endTimeLONGNO
limitINTNO默认值： 500； 最大值： 1000
apiKeySTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

备注：

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

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

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

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

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

数据源: 数据库

响应:

订单列表的状态报告与 orderList.status 相同。

{
    "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": "f4ce6a53-a29d-4f70-823b-4ab59391d6e8",
    "method": "myTrades",
    "params": {
        "symbol": "BTCUSDT",
        "startTime": 1660780800000,
        "endTime": 1660867200000,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "c5a5ffb79fd4f2e10a92f895d488943a57954edf5933bde3338dfb6ea6d6eefc",
        "timestamp": 1661955125250
    }
}

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

权重:

条件权重
没有 orderId20
有 orderId5

参数:

名称类型是否必需描述
symbolSTRINGYES
orderIdLONGNO
startTimeLONGNO
endTimeLONGNO
fromIdINTNO起始交易 ID
limitINTNO默认值： 500； 最大值： 1000
apiKeySTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

备注：

  • 如果指定了 fromId，则返回的交易将是 交易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": "d3783d8d-f8d1-4d2c-b8a0-b7596af5a664",
    "method": "account.rateLimits.orders",
    "params": {
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "76289424d6e288f4dc47d167ac824e859dabf78736f4348abbbac848d719eb94",
        "timestamp": 1660801839500
    }
}

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

权重: 40

参数:

名称类型是否必需描述
apiKeySTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
signatureSTRINGYES
timestampLONGYES

数据源: 缓存

响应:

{
    "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": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
    "method": "myPreventedMatches",
    "params": {
        "symbol": "BTCUSDT",
        "orderId": 35,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "c5a5ffb79fd4f2e10a92f895d488943a57954edf5933bde3338dfb6ea6d6eefc",
        "timestamp": 1673923281052
    }
}

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

这些是支持的组合：

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

参数:

名称类型是否必需描述
symbolSTRINGYES
preventedMatchIdLONGNO
orderIdLONGNO
fromPreventedMatchIdLONGNO
limitINTNO默认值：500； 最大值：1000
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES

权重:

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

数据源: 数据库

响应:

{
    "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": "g4ce6a53-a39d-4f71-823b-4ab5r391d6y8",
    "method": "myAllocations",
    "params": {
        "symbol": "BTCUSDT",
        "orderId": 500,
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "c5a5ffb79fd4f2e10a92f895d488943a57954edf5933bde3338dfb6ea6d6eefc",
        "timestamp": 1673923281052
    }
}

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

权重: 20

参数:

名称类型是否必需描述
symbolSTRINGYES
startTimeLONGNO
endTimeLONGNO
fromAllocationIdINTNO
limitINTNO默认值： 500； 最大值： 1000
orderIdLONGNO
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGNO

支持的参数组合:

参数响应
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": "d3df8a61-98ea-4fe0-8f4e-0fcea5d418b0",
    "method": "account.commission",
    "params": {
        "symbol": "BTCUSDT",
        "apiKey": "vmPUZE6mv9SD5VNHk4HlWFsOr6aKE2zvsw0MuIgwCIPy6utIco14y7Ju91duEh8A",
        "signature": "c5a5ffb79fd4f2e10a92f895d488943a57954edf5933bde3338dfb6ea6d6eefc",
        "timestamp": 1673923281052
    }
}

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

参数:

参数名类型是否必需描述
symbolSTRINGYES

权重: 20

数据源: 数据库

响应:

{
    "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": "6f5ebe91-01d9-43ac-be99-57cf062e0e30",
    "method": "order.amendments",
    "params": {
        "orderId": "23",
        "recvWindow": 5000,
        "symbol": "BTCUSDT",
        "timestamp": 1741925524887,
        "apiKey": "N3Swv7WaBF7S2rzA12UkPunM3udJiDddbgv1W7CzFGnsQXH9H62zzSCST0CndjeE",
        "signature": "0eed2e9d95b6868ea5ec21da0d14538192ef344c30ecf9fe83d58631699334dc"
    }
}

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

权重: 4

参数:

名称类型是否必需描述
symbolSTRINGYES
orderIdLONGYES
fromExecutionIdLONGNO
limitLONGNO默认值： 500； 最大值： 1000
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGNO

数据源: 数据库

响应:

{
    "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": "74R4febb-d142-46a2-977d-90533eb4d97g",
    "method": "myFilters",
    "params": {
        "recvWindow": 5000,
        "symbol": "BTCUSDT",
        "timestamp": 1758008841149,
        "apiKey": "nQ6kG5gDExDd5MZSO0MfOOWEVZmdkRllpNMfm1FjMjkMnmw1NUd3zPDfvcnDJlil",
        "signature": "7edc54dd0493dd5bc47adbab9b17bfc9b378d55c20511ae5a168456d3d37aa3a"
    }
}

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

权重: 40

参数:

名称类型是否必需描述
symbolSTRINGYES
recvWindowDECIMALNO最大值为 60000 毫秒。
支持最多三位小数的精度（例如 6000.346），以便可以指定微秒。
timestampLONGYES

数据源: 缓存

响应:

{
    "id": "1758009606869",
    "status": 200,
    "result": {
        "exchangeFilters": [
            {
                "filterType": "EXCHANGE_MAX_NUM_ORDERS",
                "maxNumOrders": 1000
            }
        ],
        "symbolFilters": [
            {
                "filterType": "MAX_NUM_ORDER_LISTS",
                "maxNumOrderLists": 20
            }
        ],
        "assetFilters": [
            {
                "filterType": "MAX_ASSET",
                "asset": "JPY",
                "limit": "1000000.00000000"
            }
        ]
    }
}