账户请求

账户信息 (USER_DATA)

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

获取当前账户信息。

权重: 20

参数:

名称	类型	是否必需	描述
`apiKey`	STRING	YES
`omitZeroBalances`	BOOLEAN	NO	如果`true`，将隐藏所有零余额。默认值：`false`。
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

数据源: 缓存 => 数据库

响应:

{
  "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	YES	按 `clientOrderId` 查找顺序
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`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：

userDataStream.start 请求
executionReport 更新

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

参数	权重
`symbol`	6
none	80

参数:

名称	类型	是否必需	描述
`symbol`	STRING	NO	如果省略，则返回所有交易对的挂单
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

数据源: 缓存 => 数据库

响应:

挂单的状态报告与 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

参数:

名称	类型	是否必需	描述
`symbol`	STRING	YES
`orderId`	LONG	NO	起始订单ID
`startTime`	LONG	NO
`endTime`	LONG	NO
`limit`	INT	NO	默认值： 500；最大值： 1000
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

备注：

如果指定了 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	NO*	通过 `orderListId` 获取订单列表。必须提供 `orderListId` 或 `origClientOrderId`。
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`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：

userDataStream.start 请求
executionReport 更新

权重: 6

参数:

名称	类型	是否必需	描述
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

数据源: 数据库

响应:

{
  "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

参数:

名称	类型	是否必需	描述
`fromId`	INT	NO	起始的 Order list ID
`startTime`	LONG	NO
`endTime`	LONG	NO
`limit`	INT	NO	默认值： 500；最大值： 1000
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

备注：

如果指定了 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
  }
}

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

权重:

条件	权重
没有 orderId	20
有 orderId	5

参数:

名称	类型	是否必需	描述
`symbol`	STRING	YES
`orderId`	LONG	NO
`startTime`	LONG	NO
`endTime`	LONG	NO
`fromId`	INT	NO	起始交易 ID
`limit`	INT	NO	默认值： 500；最大值： 1000
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

备注：

如果指定了 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

参数:

名称	类型	是否必需	描述
`apiKey`	STRING	YES
`recvWindow`	LONG	NO	值不能大于 `60000`
`signature`	STRING	YES
`timestamp`	LONG	YES

数据源: 缓存

响应:

{
  "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

参数:

名称	类型	是否必需	描述
symbol	STRING	YES
preventedMatchId	LONG	NO
orderId	LONG	NO
fromPreventedMatchId	LONG	NO
limit	INT	NO	默认值：`500`；最大值：`1000`
recvWindow	LONG	NO	赋值不得大于 `60000`
timestamp	LONG	YES

权重:

情况	权重
如果 `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

参数:

名称	类型	是否必需	描述
`symbol`	STRING	YES
`startTime`	LONG	NO
`endTime`	LONG	NO
`fromAllocationId`	INT	NO
`limit`	INT	NO	默认值： 500；最大值： 1000
`orderId`	LONG	NO
`recvWindow`	LONG	NO	不能大于 `60000`
`timestamp`	LONG	NO

支持的参数组合:

参数	响应
`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
  }
}

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

参数:

参数名	类型	是否必需	描述
`symbol`	STRING	YES

权重: 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"
      },
      "discount":                        // 以BNB支付时的标准佣金折扣。
      {
        "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

参数:

名称	类型	是否必需	描述
`symbol`	STRING	YES
`orderId`	LONG	YES
`fromExecutionId`	LONG	NO
`limit`	LONG	NO	默认值： 500；最大值： 1000
`recvWindow`	LONG	NO	不能大于 `60000`
`timestamp`	LONG	NO

数据源: 数据库

响应:

{
  "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)​

查询订单 (USER_DATA)​

当前挂单 (USER_DATA)​

账户订单历史 (USER_DATA)​

查询订单列表 (USER_DATA)​

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

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

账户成交历史 (USER_DATA)​

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

账户的 Prevented Matches (USER_DATA)​

查询分配结果 (USER_DATA)​

账户佣金费率 (USER_DATA)​

查询改单 (USER_DATA)​

账户信息 (USER_DATA)

查询订单 (USER_DATA)

当前挂单 (USER_DATA)

账户订单历史 (USER_DATA)

查询订单列表 (USER_DATA)

查询订单列表挂单 (USER_DATA)

账户订单列表历史 (USER_DATA)

账户成交历史 (USER_DATA)

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

账户的 Prevented Matches (USER_DATA)

查询分配结果 (USER_DATA)

账户佣金费率 (USER_DATA)

查询改单 (USER_DATA)