POST /evaluations:run is stateless. Supply current positions directly, plus any candidate trade alternatives. A hypothetical fill never changes inventory.
Make the desk side explicit
HELD receives the payout; OWED owes it. Position quantities are strictly positive. Candidate deltas are signed and nonzero. A positive delta adds receipt exposure and a negative delta reduces it or adds an obligation. This analytical convention does not imply a venue permits shorting.
Each candidate is an independent alternative against the same baseline. Trades inside one candidate form a simultaneous package. Duplicate holdings aggregate without losing contribution attribution.
Read the result
The response provides a baseline, candidate before/after deltas, coverage, versions, requested pricing observations and warnings. Results can include payout vectors, contribution matrices, extrema, tie counts, witnesses, rankings and offsets. Rankings cover the stated scenario domain before the result limit is applied. Filtering scenarios conditions the analysis; it cannot establish full-family extrema. An offset finding is analytical and does not imply collateral or operational netting.Several families
Separate families retain separate matrices. Exact whole-book extrema require compatible scenario tuples and currency/unit conventions, with each holding assigned once. Where local extrema cannot occur together, their sum may be a bound rather than an attainable result. Whole-book status isEXACT, BOUND or UNAVAILABLE, with an explanation.
Optional current valuation
pricing.mode can request MIDPOINT or LIQUIDATION, with an optional maximum quote age. Missing quotes, depth or fees can make valuation incomplete while structural payout analysis remains available.
Mark-to-settlement comparisons use the stated current valuation convention. Historical-entry P&L needs historical costs. An unlisted RFQ Combo may have no observed market price; the desk assesses its own premium separately.