Skip to content

Get Order Detail

Rate Limit: 10 req/sec/uid

Description

get Order Detail

HTTP Request

  • GET /api/v1/futures/trade/get_order_detail

Request Parameters

ParameterTypeRequiredDescription
orderIdstringfalseorder idAt least one of orderId or clientId is required.
clientIdstringfalseclient idAt least one of orderId or clientId is required.

Request Example

bash
curl -X 'GET'  --location 'https://fapi.bitunix.com/api/v1/futures/trade/get_order_detail?orderId=12345' \
   -H "api-key:*******" \
   -H "sign:*" \
   -H "time:1659076670000" \
   -H "language:en-US" \
   -H "Content-Type: application/json"

Response Parameters

ParameterTypeDescription
orderIdstringorder id
symbolstringTrading pair
qtystringAmount (base coin)
tradeQtystringFill amount (base coin)
positionModestringONE_WAY or HEDGE
marginModestringISOLATION or CROSS
leverageintleverage
pricestringPrice of the order.
Required if the order type is LIMIT
sidestringOrder direction
buy: BUY
sell: SELL
orderTypestringOrder type
LIMIT: limit orders
MARKET: market orders
effectstringOrder expiration date.
Required if the orderType is limit
IOC: Immediate or cancel
FOK: Fill or kill
GTC: Good till canceled(default value)
POST_ONLY: POST only
clientIdstringCustomize order ID
reduceOnlybooleanWhether or not to just reduce the position
statusstringINIT:prepare status
NEW:pending
PART_FILLED:partially filled
CANCELED:canceled
FILLEDAll filled
feestringfee
realizedPNLstringrealized pnl
tpPricestringtake profit trigger price
tpStopTypestringtake profit trigger type
MARK_PRICE
LAST_PRICE
tpOrderTypestringtake profit trigger place order type
LIMIT
MARKET
tpOrderPricestringtake profit trigger place order price
LIMIT
MARKET
required if tpOrderType is LIMIT
slPricestringstop loss trigger price
slStopTypestringstop loss trigger type
MARK_PRICE
LAST_PRICE
slOrderTypestringstop loss trigger place order type
LIMIT
MARKET
slOrderPricestringstop loss trigger place order price
LIMIT
MARKET
required if slOrderType is LIMIT
ctimeint64create timestamp
mtimeint64latest modify timestamp

Response Example

json
{"code":0,"data":{"orderId":"11111","qty":"1","tradeQty":"0.5","price":"60000","symbol":"BTCUSDT","positionMode":"HEDGE","marginMode":"ISOLATION","leverage":15,"status":"PART_FILLED","fee":"0.01","realizedPNL":"1.78","type":"LIMIT","effect":"GTC","reduceOnly":false,"clientId":"22222","tpPrice":"61000","tpStopType":"MARK","tpOrderType":"LIMIT","tpOrderPrice":"61000.1","slPrice":"59000","slStopType":"MARK","slOrderType":"LIMIT","slOrderPrice":"59000.1","source":"api","ctime":1597026383085,"mtime":1597026383085},"msg":"Success"}