Margin

Query Margin Account's Order (USER_DATA)

Either orderId or origClientOrderId must be sent.
For some historical orders cummulativeQuoteQty will be < 0, meaning the data is not available at this time.

Weight(IP): 10

get/sapi/v1/margin/order

Query parameters

symbolstring required

Example:BNBUSDT

Trading symbol, e.g. BNBUSDT

isIsolated'TRUE' | 'FALSE'

TRUE - For isolated margin
FALSE - Default, not for isolated margin

orderIdinteger

Order id

origClientOrderIdstring

Order id from client

recvWindowinteger

Example:5000

The value cannot be greater than 60000

timestampinteger required

UTC timestamp in ms

signaturestring required

Signature

Response

Interest History, response in descending order

clientOrderIdstring required

cummulativeQuoteQtystring required

executedQtystring required

icebergQtystring required

isWorkingboolean required

orderIdinteger required

origQtystring required

pricestring required

sidestring required

statusstring required

stopPricestring required

symbolstring required

isIsolatedboolean required

timeinteger required

timeInForcestring required

typestring required

updateTimeinteger required

selfTradePreventionModestring required

Example response

{
  "clientOrderId": "ZwfQzuDIGpceVhKW5DvCmO",
  "cummulativeQuoteQty": "0.00000000",
  "executedQty": "0.00000000",
  "icebergQty": "0.00000000",
  "orderId": 213205622,
  "origQty": "0.30000000",
  "price": "0.00493630",
  "side": "SELL",
  "status": "NEW",
  "stopPrice": "0.00000000",
  "symbol": "BNBBTC",
  "time": 1562133008725,
  "timeInForce": "GTC",
  "type": "LIMIT",
  "updateTime": 1562133008725,
  "selfTradePreventionMode": "NONE"
}

Changes

Changed in 2 of the 26 revisions of this API.322

Sep 2, 20236622e0c151001See the full diff
- ○
  added the required property selfTradePreventionMode to the response with the 200 status
  response-required-property-added
Oct 25, 2021a484ce871a72321See the full diff
- ▲
  for the query request parameter orderId, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter recvWindow, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ▲
  for the query request parameter timestamp, the type/format was changed from integer/ to integer/int64
  request-parameter-type-changed
- ○
  the response property clientOrderId became required for the status 200
  response-property-became-required
- ○
  the response property code became required for the status 400
  response-property-became-required
- ○
  the response property code became required for the status 401
  response-property-became-required
- ○
  the response property cummulativeQuoteQty became required for the status 200
  response-property-became-required
- ○
  the response property executedQty became required for the status 200
  response-property-became-required
- ○
  the response property icebergQty became required for the status 200
  response-property-became-required
- ○
  the response property isIsolated became required for the status 200
  response-property-became-required
- ○
  the response property isWorking became required for the status 200
  response-property-became-required
- ○
  the response property msg became required for the status 400
  response-property-became-required
- ○
  the response property msg became required for the status 401
  response-property-became-required
- ○
  the response property orderId became required for the status 200
  response-property-became-required
- ○
  the response property origQty became required for the status 200
  response-property-became-required
- ○
  the response property price became required for the status 200
  response-property-became-required
- ○
  the response property side became required for the status 200
  response-property-became-required
- ○
  the response property status became required for the status 200
  response-property-became-required
- ○
  the response property stopPrice became required for the status 200
  response-property-became-required
- ○
  the response property symbol became required for the status 200
  response-property-became-required
- ○
  the response property time became required for the status 200
  response-property-became-required
- ○
  the response property timeInForce became required for the status 200
  response-property-became-required
- ○
  the response property type became required for the status 200
  response-property-became-required
- ○
  the response property updateTime became required for the status 200
  response-property-became-required

Full history