API Reference

Get Sub Account Futures History Orders

Weight: 1

Request Parameters


PARAMETERTYPEReq'dExample valuesDESCRIPTION
symbolSTRINGYName of the contract
fromOrderIdINTEGEROrder ID
typeSTRINGYThe order type, possible types: LIMIT, STOP
startTimeLONGStart Timestamp
endTimeLONGEnd Timestamp
subAccountIdSTRINGYSub Account ID
limitINTEGER20Number of entries to return, max 500
recvWindowLONGrecv Window
timestampLONGY1714311403031Timestamp

Response Content


type = LIMIT

TYPEPARAMETERExample valuesDESCRIPTION
timeLONG1714403283482Timestamp when order is created
updateTimeLONG1714403283501Last time this order was updated
orderIdINTEGER1674930571497840128Last time this order was updated
clientOrderIdSTRING99999999980001A unique ID of the order.
symbolSTRINGETHUSDT-PERPETUALName of the contract.
priceFLOAT3000Price of the order.
leverageFLOAT5Leverage of the order.
origQtyFLOAT10000Quantity ordered
executedQtyFLOAT0Quantity of orders that has been executed
avgPriceFLOAT0Average price of filled orders.
marginLockedFLOAT6000Amount of margin locked for this order. This includes the actually margin needed plus fees to open and close the position.
typeSTRINGLIMITThe order type, possible types: LIMIT, LIMIT_MAKER, MARKET_OF_BASE
sideSTRINGBUY_OPENThe price type. Possible values include INPUT and MARKET.
priceTypeSTRINGGTCDirection of the order. Possible values include BUY_OPEN, SELL_OPEN, BUY_CLOSE, and SELL_CLOSE.
statusSTRINGNEWThe state of the order.Possible values include NEW, PARTIALLY_FILLED, FILLED, CANCELED, PARTIALLY_CANCELED, and REJECTED.
timeInForceSTRINGINPUTTime in force. Possible values include GTC,FOK,IOC, and LIMIT_MAKER

type = STOP

TYPEPARAMETERExample valuesDESCRIPTION
timeLONG1714403283482Timestamp when order is created
updateTimeLONG1714403283501Last time this order was updated
orderIdINTEGER1674930571497840128Last time this order was updated
clientOrderIdSTRING99999999980001A unique ID of the order.
symbolSTRINGETHUSDT-PERPETUALName of the contract.
priceFLOAT3000Price of the order.
leverageFLOAT5Leverage of the order.
origQtyFLOAT10000Quantity ordered
typeSTRINGSTOPThe order type, possible types: STOP
sideSTRINGBUYDirection of the order. Possible values include BUY_OPEN, SELL_OPEN, BUY_CLOSE, and SELL_CLOSE.
statusSTRINGNEWThe state of the order.Possible values include NEW, PARTIALLY_FILLED, FILLED, CANCELED, PARTIALLY_CANCELED, and REJECTED.
stopPriceSTRING3000Average price of filled orders

Liquidation Response

📘

To be released

PARAMETERTYPEExample valuesDESCRIPTION
isLiquidationOrderBOOLEANtrueWhether the order is a liquidation order
liquidationTypeSTRING"LIQUIDATION_MAKER_ADL", "LIQUIDATION_MAKER", "LIQUIDATION_TAKER". Available when isLiquidationOrder is true
indexPriceSTRINGIndex price. Available when isLiquidationOrder is true
Query Params
string
required
Defaults to ETHUSDT-PERPETUAL

Name of the contract

string

Order ID

string
required
Defaults to LIMIT

The order type, possible types: LIMIT, STOP

int64

Start Timestamp

int64

End Timestamp

string
required
Defaults to 1673782460192774144

Sub Account ID

int32

Number of entries to return, max 500

int64

recv Window

int64
required
Defaults to 1716701051911

Timestamp

string
required
Defaults to e25ba9a3458a98dc099e07ed49544285dac21f489c9b0fa9ef9a724aa1f45243

Signature

Responses

Language
Credentials
Click Try It! to start a request and see the response here! Or choose an example:
application/json