Get a manual execution
Serves one manual execution of the organisation; any other id is 404. A member without the surface is 503 RISK_UNAVAILABLE. Needs risk:read or any risk capability.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
The manual execution’s id — a positive 64-bit integer as decimal digits.
Headers
Your own id for the request: 8 to 128 of [A-Za-z0-9._-]. It becomes the request’s id and is echoed on the response. A value off that grammar is replaced with a fresh id, never refused.
Query parameters
A position you hold — an X-Immix-Global-Sequence you read, or a 202’s commandGlobalSequence: this member answers only once it has folded the platform’s stream through it, waiting up to its deadline, then 503 PROJECTION_BEHIND with Retry-After. Within that stream a read is never older than what you have seen; drop your positions after an announced stream cut. A retry stating its 202’s position attaches to or replays that operation while the journal holds its key, never publishing twice. Stated once: one to nineteen digits, at most 9223372036854775807; else 400 MALFORMED_REQUEST.
Response
The manual execution, with the position header and body field and the ETag.
The manual execution’s id, a 64-bit integer as decimal digits.
Its version as a decimal string: 1 when drafted, one more for each approval and for the withdrawal; its ETag.
The account the trade is booked to (GET /accounts).
The instrument traded, as POST /orders names it by instrumentId, listed at the account’s venue.
The account’s side of the trade. The value set is append-only: read an unknown value as UNKNOWN.
Whether the account made or took liquidity, when known; UNKNOWN otherwise.
money (an exact decimal string at the scale it was drafted at): the quantity traded, in the instrument’s own unit (contracts for a swap).
money (an exact decimal string at the scale it was drafted at): the price traded at.
money (an exact decimal string at the scale it was drafted at): the fee charged in feeAssetId, negative for a rebate; null when none was drafted.
The asset the fee is in; null when none was drafted.
When it traded at the venue or counterparty, epoch nanoseconds — the execution’s fillTsNs and venueTsNs.
Why it was booked by hand. The value set is append-only: read an unknown value as UNKNOWN.
The venue’s trade id, or the counterparty’s or desk’s reference: the execution’s venueTradeId, which a reconciliation matches.
PENDING_APPROVAL: drafted, booking nothing until approved. RECORDED: booked as the execution executionId names. WITHDRAWN: withdrawn, never booked. The value set is append-only: read an unknown value as UNKNOWN.
The maker — an actor, always a member’s: only members write risk.
Who approved it and when, in approval order; empty until the first approval. It is recorded when they number the organisation’s risk rule in force at that approval, and at least one (GET /approval-rules?family=RISK).
When it was recorded, epoch nanoseconds; null until then.
The execution it was recorded as (GET /executions/{id}); null until then.
Who withdrew it; null unless withdrawn.
Who produced this version, never null: the maker on the draft, an approver on an approval, the withdrawer on the withdrawal.
Why it was withdrawn; empty unless withdrawn.
The position as a decimal string — the last change this member had applied, orders, balance readings and algo instances included.