Payload: Order update
#
Event DescriptionOrders are updated with the executionReport
event.
Execution types:
- NEW - The order has been accepted into the engine.
- CANCELED - The order has been canceled by the user.
- REPLACED (currently unused)
- REJECTED - The order has been rejected and was not processed (This message appears only with Cancel Replace Orders wherein the new order placement is rejected but the request to cancel request succeeds.)
- TRADE - Part of the order or all of the order's quantity has filled.
- EXPIRED - The order was canceled according to the order type's rules (e.g. LIMIT FOK orders with no fill, LIMIT IOC or MARKET orders that partially fill) or by the exchange, (e.g. orders canceled during liquidation, orders canceled during maintenance).
- TRADE_PREVENTION - The order has expired due to STP trigger.
Check the Public API Definitions for more relevant enum definitions.
These are fields that appear in the payload only if certain conditions are met.
Field | Name | Description | Examples |
---|---|---|---|
d | Trailing Delta | Appears only for trailing stop orders. | "d": 4 |
D | Trailing Time | "D": 1668680518494 | |
j | Strategy Id | Appears only if the strategyId parameter was provided upon order placement. | "j": 1 |
J | Strategy Type | Appears only if the strategyType parameter was provided upon order placement. | "J": 1000000 |
v | Prevented Match Id | Appears only for orders that expired due to STP. | "v": 3 |
A | Prevented Quantity | "A":"3.000000" | |
B | Last Prevented Quantity | "B":"3.000000" | |
u | Trade Group Id | "u":1 | |
U | Counter Order Id | "U":37 | |
Cs | Counter Symbol | "Cs": "BTCUSDT" | |
pl | Prevented Execution Quantity | "pl":"2.123456" | |
pL | Prevented Execution Price | "pL":"0.10000001" | |
pY | Prevented Execution Quote Qty | "pY":"0.21234562" | |
W | Working Time | Appears when the order is working on the book | "W": 1668683798379 |
b | Match Type | Appears for orders that have allocations | "b":"ONE_PARTY_TRADE_REPORT" |
a | Allocation ID | "a":1234 | |
k | Working Floor | Appears for orders that could potentially have allocations | "k":"SOR" |
uS | UsedSor | Appears for orders that used SOR | "uS":true |
#
Event NameexecutionReport
#
Response ExamplePayload:
If the order is an OCO, an event will be displayed named ListStatus
in addition to the executionReport
event.