Interface TradeApiInterface

Cancel an active algo order.

Weight(IP): 1

Security Type: TRADE

Notes:

• Either algoId or clientAlgoId must be sent.

Cancel an active order.

Weight(IP): 1

Security Type: TRADE

Notes:

• Either orderId or origClientOrderId must be sent.

Order modify function, currently only LIMIT order modification is supported, modified orders will be reordered in the match queue

Weight: 1 on 10s order rate limit(X-MBX-ORDER-COUNT-10S); 1 on 1min order rate limit(X-MBX-ORDER-COUNT-1M); 0 on IP rate limit(x-mbx-used-weight-1m)

Security Type: TRADE

Notes:

• Either orderId or origClientOrderId must be sent, and the orderId will prevail if both are sent.

• Both quantity and price must be sent. (After CM migration, the dapi modify order endpoint follows the same rule.)

• When the new quantity or price doesn't satisfy PRICE_FILTER / PERCENT_FILTER / LOT_SIZE, amendment will be rejected and the order will stay as it is.

• However the order will be cancelled by the amendment in the following situations:

• when the order is in partially filled status and the new quantity <= executedQty

• When the order is GTX and the new price will cause it to be executed immediately

• One order can only be modfied for less than 10000 times

• reduceOnly behavior:

• false or omitted: behave as today — min_notional is enforced on the modified order.

• true and the original order's reduceOnly attribute is also true (consistent): the min_notional check is skipped on the modified order, matching placement semantics.

• true but the original order's reduceOnly attribute is false (inconsistent): the modify request is rejected with error code -5047, "The original order is not a reduce-only order".

• reduceOnly is used purely for validation — passing true does not change the original order's reduceOnly attribute; that flag remains whatever it was set to at placement time.

Send in a new algo order.

Weight(IP): 0

Security Type: TRADE

Notes:

• Condition orders will be triggered when:

• If parameterpriceProtectis sent as true:

• when price reaches the triggerPrice ，the difference rate between "MARK_PRICE" and "CONTRACT_PRICE" cannot be larger than the "triggerProtect" of the symbol

• "triggerProtect" of a symbol can be got from GET /fapi/v1/exchangeInfo

• STOP, STOP_MARKET:

• BUY: latest price ("MARK_PRICE" or "CONTRACT_PRICE") >= triggerPrice

• SELL: latest price ("MARK_PRICE" or "CONTRACT_PRICE") <= triggerPrice

• TAKE_PROFIT, TAKE_PROFIT_MARKET:

• BUY: latest price ("MARK_PRICE" or "CONTRACT_PRICE") <= triggerPrice

• SELL: latest price ("MARK_PRICE" or "CONTRACT_PRICE") >= triggerPrice

• TRAILING_STOP_MARKET:

• BUY: the lowest price after order placed <= activatePrice, and the latest price >= the lowest price * (1 + callbackRate)

• SELL: the highest price after order placed >= activatePrice, and the latest price <= the highest price * (1 - callbackRate)

• For TRAILING_STOP_MARKET, if you got such error code.

{"code": -2021, "msg": "Order would immediately trigger."}

means that the parameters you send do not meet the following requirements:

• BUY: activatePrice should be smaller than latest price.

• SELL: activatePrice should be larger than latest price.

• STOP_MARKET, TAKE_PROFIT_MARKET with closePosition=true:

• Follow the same rules for condition orders.

• If triggered，close all current long position( if SELL) or current short position( if BUY).

• Cannot be used with quantity paremeter

• Cannot be used with reduceOnly parameter

• In Hedge Mode,cannot be used with BUY orders in LONG position side. and cannot be used with SELL orders in SHORT position side

• selfTradePreventionMode is only effective when timeInForce set to IOC or GTC or GTD.

Send in a new order.

Weight(IP): 0

Security Type: TRADE

Notes: Additional mandatory parameters based on type:

• LIMIT: timeInForce, quantity, price
• MARKET: quantity

• If newOrderRespType is sent as RESULT:

  • MARKET order: the final FILLED result of the order will be return directly.
  • LIMIT order with special timeInForce: the final status result of the order(FILLED or EXPIRED) will be returned directly.

• selfTradePreventionMode is only effective when timeInForce set to IOC or GTC or GTD.

• In extreme market conditions, timeInForce GTD order auto cancel time might be delayed comparing to goodTillDate

Get current position information.

Weight(IP): 5

Security Type: USER_DATA

Notes:

• Please use with user data stream ACCOUNT_UPDATE to meet your timeliness and accuracy needs.

Get current position information(only symbol that has position or open orders will be returned).

Weight(IP): 5

Security Type: USER_DATA

Notes:

• Please use with user data stream ACCOUNT_UPDATE to meet your timeliness and accuracy needs.

Check an order's status.

These orders will not be found: order status is CANCELED or EXPIRED AND order has NO filled trade AND created time + 3 days < current time order create time + 90 days < current time

Weight(IP): 1

Security Type: USER_DATA

Notes: Notes:

• Either orderId or origClientOrderId must be sent.
• orderId is self-increment for each specific symbol