账户接口
账户信息 (USER_DATA)
GET /api/v3/account
获取当前账户信息。
权重: 20
参数:
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| omitZeroBalances | BOOLEAN | NO | 默认值: false。 如果 true,将隐藏所有零余额。 |
| recvWindow | DECIMAL | NO | 最大值: 60000。 支持最多三位小数的精度(例如 6000.346),以便可以指定微秒。 |
| timestamp | LONG | YES | 用于请求签名的 Unix 时间戳,单位为毫秒或微秒。该值必须反映客户端当前时间,并会在签名接口中由服务器进行校验。 |
数据源: 缓存 => 数据库
响应:
{
"makerCommission": 15,
"takerCommission": 15,
"buyerCommission": 0,
"sellerCommission": 0,
"commissionRates": {
"maker": "0.00150000",
"taker": "0.00150000",
"buyer": "0.00000000",
"seller": "0.00000000"
},
"canTrade": true,
"canWithdraw": true,
"canDeposit": true,
"brokered": false,
"requireSelfTradePrevention": false,
"preventSor": false,
"updateTime": 123456789,
"accountType": "SPOT",
"balances": [
{
"asset": "BTC",
"free": "4723846.89208129",
"locked": "0.00000000"
},
{
"asset": "LTC",
"free": "4763368.68006011",
"locked": "0.00000000"
}
],
"permissions": [
"SPOT"
],
"uid": 354937868
}
查询订单 (USER_DATA)
GET /api/v3/order
查询订单状态
权重: 4
参数:
| 名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
| symbol | STRING | YES | |
| orderId | LONG | NO | |
| origClientOrderId | STRING | NO | |
| recvWindow | DECIMAL | NO | 最大值: 60000。 支持最多三位小数的精度(例如 6000.346),以便可以指定微秒。 |
| timestamp | LONG | YES | 用于请求签名的 Unix 时间戳,单位为毫秒或微秒。该值必须反映客户端当前时间,并会在签名接口中由服务器进行校验。 |
数据源: 缓存 => 数据库
- 至少需要发送
orderId与origClientOrderId中的一个。 - 当同时提供
orderId和origClientOrderId两个参数时,系统首先将会使用orderId来搜索 订单。然后, 查找结果中的origClientOrderId的值将会被用来验证订单。如果两个条件都不满足,则请求将被拒绝。 - 某些历史订单的
cummulativeQuoteQty会 < 0, 表示当前暂无该数据。
响应:
{
"symbol": "LTCBTC", // 交易对
"orderId": 1, // 系统的订单ID
"orderListId": -1, // 除非此单是订单列表的一部分, 否则此值为 -1
"clientOrderId": "myOrder1", // 客户自己设置的ID
"price": "0.1", // 订单价格
"origQty": "1.0", // 用户设置的原始订单数量
"executedQty": "0.0", // 交易的订单数量
"origQuoteOrderQty": "0.000000", // 原始的交易金额
"cummulativeQuoteQty": "0.0", // 累计交易的金额
"status": "NEW", // 订单状态
"timeInForce": "GTC", // 订单的时效方式
"type": "LIMIT", // 订单类型, 比如市价单,现价单等
"side": "BUY", // 订单方向,买还是卖
"stopPrice": "0.00000000", // 出现在 STOP_LOSS, TAKE_PROFIT, STOP_LOSS_LIMIT 和 TAKE_PROFIT_LIMIT 订单中。
"icebergQty": "0.00000000", // 仅在请求中发送了 icebergQty 参数时出现。
"time": 1499827319559, // 订单时间
"updateTime": 1499827319559, // 最后更新时间
"isWorking": true, // 订单是否出现在orderbook中
"workingTime": 1499827319559, // 订单添加到 order book 的时间
"selfTradePreventionMode": "NONE", // 如何处理自我交易模式
"preventedMatchId": 0, // 仅在因 STP 导致订单失效时出现。
"preventedQuantity": "1.200000", // 因 STP 导致订单失效的数量。
"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" // 订单过期的原因。当订单过期时出现。
}
注意: 上面的 payload 没有显示所有可以出现的字段,更多请看 订单响应中的特定条件时才会出现的字段 部分。