Get Order Detail
Frequency limit: 10 times/1s (uid)
Description
Get order detail
HTTP Request
- GET /api/v2/mix/order/detail
Request Example
curl "https://api.bitget.com/api/v2/mix/order/detail?symbol=ETHUSDT&orderId=1&clientOid=1&productType=usdt-futures" \
-H "ACCESS-KEY:your apiKey" \
-H "ACCESS-SIGN:*" \
-H "ACCESS-PASSPHRASE:*" \
-H "ACCESS-TIMESTAMP:1659076670000" \
-H "locale:zh-CN" \
-H "Content-Type: application/json"
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | String | Yes | Product ID must be capitalized |
| productType | String | Yes | Product typeUSDT-FUTURES USDT-M FuturesCOIN-FUTURES Coin-M FuturesUSDC-FUTURES USDC-M Futures |
| orderId | String | No | Order ID Either 'orderId' or 'clientOid' is required. |
| clientOid | String | No | Custom order ID Either 'orderId' or 'clientOid' is required. |
Response Example
{
"code": "00000",
"msg": "success",
"requestTime": 1695823012595,
"data": {
"symbol": "ethusdt",
"size": "2",
"orderId": "123456",
"clientOid": "77777",
"baseVolume": "2",
"priceAvg": "1900",
"fee": "",
"price": "1900",
"state": "filled",
"side": "buy",
"force": "gtc",
"totalProfits": "2112",
"posSide": "long",
"marginCoin": "usdt",
"presetStopSurplusPrice": "1910",
"presetStopSurplusType":"fill_price",
"presetStopSurplusExecutePrice":"1911",
"presetStopLossPrice": "1890",
"presetStopLossType":"fill_price",
"presetStopLossExecutePrice":"1989",
"quoteVolume": "1900",
"orderType": "limit",
"leverage": "20",
"marginMode": "cross",
"reduceOnly": "yes",
"enterPointSource": "api",
"tradeSide": "",
"posMode": "one_way_mode",
"orderSource": "normal",
"cancelReason": "",
"cTime": "1627300098776",
"uTime": "1627300098776"
}
}
Return Parameter
| Parameter | Type | Description |
|---|---|---|
| symbol | String | Trading pair |
| size | String | Amount |
| orderId | String | Order ID |
| clientOid | String | Customize order ID |
| baseVolume | String | Amount of coins traded |
| priceAvg | String | Average price |
| fee | String | Transaction fee |
| price | String | Order price |
| status | String | Order statuslive: New order, waiting for a match in orderbookpartially_filled: Partially filledfilled: All filledcanceled: the order is cancelled |
| side | String | Directionbuysell |
| force | String | Order expiration dateioc: Immediate or cancelfok: Fill or killgtc: Good till canceledpost only: post only orders |
| totalProfits | String | Total PnL |
| posSide | String | Position directionlong: hedge mode long positionshort: hedge mode short positionnet: one-way position |
| marginCoin | String | Margin coin |
| presetStopSurplusPrice | String | Set TP |
| presetStopSurplusType | String | Preset Take Profit Trigger type fill_price: market price; mark_price: mark price |
| presetStopSurplusExecutePrice | String | Preset Take Profit Execution price |
| presetStopLossPrice | String | Set SL |
| presetStopLossType | String | Preset Stop Loss Trigger type fill_price: market price; mark_price: mark price |
| presetStopLossExecutePrice | String | Preset Stop Loss Execution price |
| quoteVolume | String | Trading amount in quoting coin |
| orderType | String | Order type limit market |
| leverage | String | Leverage |
| marginMode | String | Margin modeisolated: isolated margincrossed: cross margin |
| reduceOnly | String | Whether or not to just reduce the position.YESNO |
| enterPointSource | String | Order source WEB: Orders created on the website API: Orders created on API SYS: System managed orders, usually generated by forced liquidation logic ANDROID: Orders created on the Android app IOS: Orders created on the iOS app |
| tradeSide | String | Directionclose: Close (open and close mode)open: Open (open and close mode)reduce_close_long: Liquidate partial long positions for hedge position modereduce_close_short:Liquidate partial short positions for hedge position modeburst_close_long:Liquidate long positions for hedge position modeburst_close_short:Liquidate short positions for hedge position modeoffset_close_long:Liquidate partial long positions for netting for hedge position modeoffset_close_short:Liquidate partial short positions for netting for hedge position modedelivery_close_long:Delivery long positions for hedge position modedelivery_close_short:Delivery short positions for hedge position modedte_sys_adl_close_long:ADL close long position for hedge position modedte_sys_adl_close_short:ADL close short position for hedge position modebuy_single:Buy, one way postion modesell_single:Sell, one way postion modereduce_buy_single:Liquidate partial positions, buy, one way position modereduce_sell_single:Liquidate partial positions, sell, one way position modeburst_buy_single:Liquidate short positions, buy, one way postion modeburst_sell_single:Liquidate partial positions, sell, one way position modedelivery_sell_single:Delivery sell, one way position modedelivery_buy_single:Delivery buy, one way position modedte_sys_adl_buy_in_single_side_mode:ADL close position, buy, one way position modedte_sys_adl_sell_in_single_side_mode:ADL close position, sell, one way position mode |
| posMode | String | Position modeone_way_mode: one-way positionhedge_mode: two-way position |
| orderSource | String | Order source normal: Normal order market: market order profit_market: Market TP order loss_market: Market SL order Trader_delegate: Elite trade order trader_profit: Trader takes profit trader_loss: Trader stops loss reverse: Reversed orders trader_reverse: Reversed elite trades profit_limit: Take-profit limit order loss_limit: Stop-loss limit order liquidation: Liquidation order delivery_close_long: close long positions delivery_close_short: close short positions pos_profit_limit: Position take-profit limit order pos_profit_market: Position take-profit market order pos_loss_limit: Position stop-loss limit order pos_loss_market: Position stop-loss market order profit_chase: Take Profit Chase Order loss_chase: Stop Loss Chase Order follower_delegate: Follower Delegate Order reduce_offset: Reduce Position Offset Order market_risk: Best Price Risk Handling plan_limit: Limit Plan Order plan_market: Best Price Plan Order pos_loss_limit: Position Stop Loss Limit strategy_positive: Strategy-Positive Grid strategy_reverse: Strategy-Reverse Grid strategy_unlimited: Unlimited Strategy move_limit: Limit Moving Take Profit and Stop Loss move_market: Best Price Moving Take Profit and Stop Loss tracking_limit: Limit Trailing Order tracking_market: Best Price Trailing Order strategy_dca_positive: DCA Strategy-Positive strategy_dca_reverse: DCA Strategy-Reverse strategy_oco_limit: Strategy-OCO Limit Order strategy_oco_trigger: Strategy-OCO Trigger Order modify_order_limit: Limit Modify Order strategy_regular_buy: Strategy-Regular Buy strategy_grid_middle: Strategy-Neutral Grid |
| cancelReason | String | Cancel reasonnormal_cancel: Normal cancelstp_cancel: Cancelled by STP |
| cTime | String | Creation time, ms |
| uTime | String | Update time, ms |