查询历史委托
描述
此接口用于查询历史委托的合约订单。
HTTP请求
GET /v3/trade/order/history
请求参数
参数 | 是否必填 | 类型 | 描述 |
---|---|---|---|
symbol | 否 | String | 交易对。常用形式为“基础货币”+“报价货币” |
side | 否 | String | 成交方向;枚举:BUY 和 SELL |
ordId | 否 | String | 订单的订单 ID |
clOrdId | 否 | String | 用户自定义订单ID |
state | 否 | String | 订单状态;枚举:FILLED 已成交、PARTIAL_CANCELED :部分成交已撤销、CANCELED :已撤销 |
type | 否 | String | 订单类型;枚举:MARKET 、LIMIT 、LIMIT_MAKER |
sTime | 否 | String | 查询开始时间,UNIX时间戳,以毫秒为单位。默认是最近180天 |
eTime | 否 | String | 查询结束时间,UNIX时间戳,以毫秒为单位。默认是最近180天 |
from | 否 | Long | ordId ,查询的起始id,默认从0开始 |
limit | 否 | Integer | 分页页面大小,默认为10,最大为100。 |
direct | 否 | String | 枚举:PREV , NEXT ;默认是 NEXT |
响应参数
参数 | 类型 | 描述 |
---|---|---|
symbol | String | 交易对。常用形式为“基础货币”+“报价货币” |
side | String | 枚举:BUY 和 SELL |
type | String | 订单类型;枚举:MARKET , LIMIT , LIMIT_MAKER |
ordId | String | 订单编号 |
clOrdId | String | 用户自定义订单ID |
mgnMode | String | 保证金模式;枚举:ISOLATED 逐仓,CROSS 全仓 |
px | String | 委托价格 |
sz | String | 委托张数 |
state | String | 订单状态;枚举:NEW , PARTIALLY_FILLED , FILLED , PARTIALLY_CANCELED , CANCELED , REJECTED |
cancelReason | String | USER_CANCEL_ORDER_ACTION , LIMIT_MAKER_ORDER_INCORRECT_PRICE_CONDITION , LIMIT_MATCH_IOC_OR_FOK_ORDER_PRICE_CANNOT_MATCH , LIMIT_MATCH_FOK_ORDER_MAKER_INSUFFICIENT_AVAILABLE_QUANTITY , LIMIT_MATCH_IOC_ORDER_CANNOT_FILLED , LIMIT_MATCH_ORDER_TAKER_SELF_TRADE ,MARKET_ORDER_NO_OTHER_SIDE_ORDER , INVALID_PARAM_WHEN_PLACE_ORDER , INVALID_ORDER_TYPE_WHEN_PLACE_ORDER , INVALID_SEQUENCE_PLACE_ORDER_AFTER_CANCEL_SAME_ORDER , MATCH_SYMBOL_TRADE_LIMIT_NOT_EXIST , EXCEED_SLIPPAGE_TOLERANCE , OUT_OF_RANGE_LIMIT_PRICE ,NO_MARGIN_QUANTITY_GREAT_THAN_POSITION , LIMIT_MATCH_ORDER_ONLY_SELF_TRADE , FL_CANCEL_ORDER_ACTION , RISK_CANCEL_ORDER_ACTION , SYS_CANCEL_ORDER_ACTION |
source | String | Order Source: Enumerate WEB , APP , API , SMART , WEB_MARGIN , APP_IOS , APP_ANDROID , APP_IOS_MARGIN , APP_ANDROID_MARGIN , API_MARGIN , SMART_MARGIN , WS , WS_MARGIN , GRID , GRID_MARGIN , SYSTEM , COPY_TRADING , TRIGGER , LIQUIDATION , ADL , TRIAL , MARGIN_FL , MARGIN_FL_OFFLINE |
reduceOnly | Boolean | 只减仓 |
timeInForce | String | 枚举:FOK ,IOC ,GTC ;可选,默认为 GTC |
avgPx | String | 平均成交价格 |
execQty | String | 累计成交数量 |
execAmt | String | 累计成交金额 |
feeCcy | String | 手续费币种名称 |
feeAmt | String | 累计手续费数量 |
deductCcy | String | 手续费抵扣币种名称 |
deductAmt | String | 累计手续费抵扣数量 |
stpMode | String | Enumerate - EXPIRE_TAKER - EXPIRE_MAKER - EXPIRE_BOTH 默认为NONE |
cTime | String | 订单创建时间, UTC时间戳(MS) |
uTime | String | 订单更新时间, UTC时间戳(MS) |
请求示例
{
"symbol": "BTC_USDT_PERP",
"direct": "NEXT",
"From": "0",
"limit": 100,
"sTime": "1719971873000",
"eTime": "1719973853000"
}
响应示例
{
"code": 200,
"data": [
{
"avgPx": "0.6272",
"cTime": "1719973768748",
"cancelReason": "",
"clOrdId": "polo331380922769473536",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "1.8816",
"execQty": "3",
"feeAmt": "0.00009408",
"feeCcy": "USDT",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331380922769473536",
"px": "60000",
"reduceOnly": "false",
"side": "BUY",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "WEB",
"state": "FILLED",
"stpMode": "NONE",
"symbol": "BTC_USDT_PERP",
"sz": "3",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973768764"
},
{
"avgPx": "0.6272",
"cTime": "1719973712694",
"cancelReason": "",
"clOrdId": "12345",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "1.8816",
"execQty": "3",
"feeAmt": "0.00009408",
"feeCcy": "USDT",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331380687661957120",
"px": "0",
"reduceOnly": "true",
"side": "BUY",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "FILLED",
"stpMode": "NONE",
"symbol": "BTC_USDT_PERP",
"sz": "3",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "MARKET",
"uTime": "1719973712703"
},
{
"avgPx": "0",
"cTime": "1719973298692",
"cancelReason": "ORDER_SOURCE_API",
"clOrdId": "4251fe5c-2b1e-4abd-b9b2-e7c713435653",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331378951211712512",
"px": "60000",
"reduceOnly": "false",
"side": "SELL",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973526115"
},
{
"avgPx": "0",
"cTime": "1719973298689",
"cancelReason": "ORDER_SOURCE_API",
"clOrdId": "9e36e89c-6cab-45c6-9c8a-245b7547601a",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331378951199129601",
"px": "60000",
"reduceOnly": "false",
"side": "SELL",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973454788"
},
{
"avgPx": "0",
"cTime": "1719973298688",
"cancelReason": "ORDER_SOURCE_API",
"clOrdId": "1e073485-dfdc-44b9-9523-3daa871984f3",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331378951194935296",
"px": "60000",
"reduceOnly": "false",
"side": "BUY",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973642669"
},
{
"avgPx": "0",
"cTime": "1719973298685",
"cancelReason": "ORDER_SOURCE_API",
"clOrdId": "225c8607-d98f-4a2e-a27b-faea04fe718f",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331378951182352384",
"px": "60000",
"reduceOnly": "false",
"side": "BUY",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973454787"
},
{
"avgPx": "0",
"cTime": "1719972857477",
"cancelReason": "USER_CANCEL_ORDER_ACTION",
"clOrdId": "c9a20e43-1dda-45f4-9f69-3c0656b53161",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331377100621873152",
"px": "60000",
"reduceOnly": "false",
"side": "SELL",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973253399"
},
{
"avgPx": "0",
"cTime": "1719972857475",
"cancelReason": "USER_CANCEL_ORDER_ACTION",
"clOrdId": "fa8011fe-8312-4b23-a671-b0ed34df3f30",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331377100613484545",
"px": "60000",
"reduceOnly": "false",
"side": "SELL",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973253398"
},
{
"avgPx": "0",
"cTime": "1719972857473",
"cancelReason": "USER_CANCEL_ORDER_ACTION",
"clOrdId": "57faf779-d45b-46ee-87e6-9cb11d5804f4",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331377100605095936",
"px": "60000",
"reduceOnly": "false",
"side": "BUY",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973253397"
},
{
"avgPx": "0",
"cTime": "1719972857465",
"cancelReason": "USER_CANCEL_ORDER_ACTION",
"clOrdId": "2486353f-64d3-4f7d-aa0a-7e34f45b6a6e",
"deductAmt": "0",
"deductCcy": "0",
"execAmt": "0",
"execQty": "0",
"feeAmt": "0",
"feeCcy": "",
"lever": "20",
"mgnMode": "CROSS",
"ordId": "331377100571541504",
"px": "60000",
"reduceOnly": "false",
"side": "BUY",
"slPx": "",
"slTrgPx": "",
"slTrgPxType": "",
"source": "API",
"state": "CANCELED",
"stpMode": "EXPIRE_TAKER",
"symbol": "BTC_USDT_PERP",
"sz": "2",
"timeInForce": "GTC",
"tpPx": "",
"tpTrgPx": "",
"tpTrgPxType": "",
"type": "LIMIT",
"uTime": "1719973253396"
}
],
"msg": "Success"
}