report_fill
Apply fills, commissions, or lifecycle statuses to an existing order; terminal statuses release remaining reservations, while drop-copy reports stay unsigned.
Instructions
Apply an execution report - a fill, a commission or a lifecycle status - to an order returned by submit_order or submit_drop_copy_order; the instrument, account and side come from the order. A report on an ordinary order is signed and attested fail-closed and returns its attestation, unsigned under eSign-off; a report on a drop-copy order stays unsigned and returns no attestation, because drop-copy never enforced a pre-trade verdict. filled and partially_filled carry a fill; rejected, rolled_back, filled and cancelled are terminal and release the order's remaining reservation. A report on a terminal order is refused with terminal_order, on a venue-linked order with venue_order_managed, and a repeated id with conflict. Mutates engine state; protected and disabled by default.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Optional caller-supplied unique report id; omit to have the store assign one; a repeated id is refused with conflict | |
| order | Yes | Order id returned by submit_order or submit_drop_copy_order | |
| price | No | Fill price as an exact decimal string; required with quantity for filled and partially_filled and refused for every other status | |
| status | Yes | Target lifecycle status: submitted, accepted, rejected, committed, rolled_back, filled, partially_filled or cancelled; rejected, rolled_back, filled and cancelled are terminal | |
| quantity | No | Fill quantity as an exact decimal string; required with price for filled and partially_filled and refused for every other status | |
| lockPrice | No | Display lock price as a plain decimal string without surrounding space or exponent, recorded on the report event, the trade and the attestation; settlement uses the order's stored pre-trade lock, never this value; refused for the non-terminal workflow statuses submitted, accepted and committed | |
| commission | No | Optional fee (positive amount) or rebate (negative amount) with its currency code, forwarded to the engine as one value without currency conversion; omit for none, and when present amount and currency must both be non-empty | |
| leavesQuantity | No | Caller-reported open base quantity as a non-negative plain decimal string, recorded verbatim on the order, the report event and the attestation; required with a fill, optional otherwise; the SDK receives the order's own recorded reservation remainder |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | ||
| result | Yes | ||
| signed | Yes | ||
| attestationKeyId | No | ||
| signedAttestation | No |