Reference / Trade execution

Outcomes

An outcome is what Praxis reports back about a request: which account and trade it belongs to, where it has got to, how much has filled and at what average, a pair of figures counting slices, why, and when that was true.

Contents

The same thing carries progress and completion. Two of its six states are not an ending — waiting, and part done — and four are: filled, cancelled, refused, and expired.

An outcome is refused as it is made unless its names are real names rather than empty ones, unless its time carries a zone, and unless its figures agree.

What those figures are worth differs by which producer made the outcome.

What becomes of it

An outcome is written down, then handed to the caller — where a caller was given at all; with none, the handing over is skipped.

Where the handing over does not finish, the next start goes looking for it. That looking covers only the numbered period the host was started in. An outcome from an earlier period falls outside it.

Source evidence
---
row: P2-18
baseline: 49aa659
created: 2026-09-26 20:21 UTC
modified: 2026-10-09 07:31 UTC
evidence:
  - claim: "An outcome is built with the names, a status, the amount filled and its average, a pair of slice figures, a reason and a time"
    source: "`execution_manager.py` 10784-10798"
  - claim: "Two statuses are not an ending and four are"
    source: "`praxis/core/domain/enums.py` 171-176, the four gathered at `praxis/core/domain/trade_outcome.py` 23-28 and tested at 171"
  - claim: "Its names must be real names and its time must carry a zone"
    source: "`praxis/core/domain/trade_outcome.py` 111-116"
  - claim: "It is handed to a caller where one was given"
    source: "`execution_manager.py` 757-758, dispatched at 10834"
  - claim: "A restart looks only within the epoch it was told to run"
    source: "`launcher.py` 4521-4526"
  - claim: "How far along it is cannot be given where no target was"
    source: "`praxis/core/domain/trade_outcome.py` 182-185"
---

Edit this sourceCheckout revision · 7381aa49
Reference / keep your place
Find a passage