01 / SETTLEMENT

It reads the screen
or it refunds.

An agent registers a moment. Vision reads the footage. The resolver returns one state and a settlement_id. A bad read never mis-pays.

AUTO

Terminal score is stable and the read clears the bar.

Example: Fortnite "VICTORY" on a clean VOD can settle without a second reader.

Agent: The agent receives AUTO and the settlement_id. Pulse may release the pool.

CONFIRM

Two signals disagree. The banner says one thing, another on-screen element says something else.

Example: A Madden read that does not match the in-game bar is held for a person.

Agent: The agent receives CONFIRM. Nothing is auto-paid. A human resolves or the moment refunds.

VOID

The terminal state has no winner.

Example: A Counter-Strike 2 match that ends tied is voided and refunded, not guessed.

Agent: The agent receives VOID. Stakes return. No one is scored as right.

HOLD

No candidate clears the bar.

Example: Ambiguous footage settles nothing. Stakes stay put.

Agent: The agent receives HOLD. The moment stays open until a clean read or a refund. It does not time out into a guess.

Three of the four states pay nobody.

Automated live settlement is off. Vision on this site is described from recorded video unless a coverage cell says otherwise.

The internal bench is an internal bench. It is not a certification. See the matrix.

Policy

  • The agent stores settlement_id. That id is the record of the state, the title, the moment, and the time.
  • CONFIRM never flips to AUTO because a deadline arrived.
  • VOID and HOLD are successful oracle responses. They are not errors to retry until money moves.
  • A human on CONFIRM is a named review path, not a hidden edit of the footage.
  • Pulse cannot release a pool on CONFIRM, VOID, or HOLD.

Transitions

FromToVerb
openlockedPOST /v1/events/:id/lock
openvoidedPOST /v1/events/:id/void
lockedheldPOST /v1/events/:id/hold
lockedsettledPOST /v1/events/:id/settle
lockedvoidedPOST /v1/events/:id/void
heldsettledPOST /v1/events/:id/settle
heldvoidedPOST /v1/events/:id/void
settledreversedPOST /v1/events/:id/reverse
reversedterminal · no transitions
voidedterminal · no transitions

Fields

FieldTypeNotes
event_idstringStable id across every mode and state.
settlement_idstring | nullHash-chained ledger id. null until settled.
stateEventStateopen | locked | held | settled | reversed | voided.
type'promo' | 'contest' | 'duel'Mode flag. Same machine for all three.
path'vod' | 'live'live: auto-certified titles settle without reviewer_id; uncertified require it.
specobjecttitle and question the outcome is judged against.
stake_refstring | nullOperator reference. Forbidden on type=promo.
model_versionstringExact model build that produced the call.
confidencenumber 0–1Model score for the outcome.
thresholdnumber 0–1settle rejected when confidence < threshold.
outcomeyes | no | void | nullnull until settled or voided.
evidence_uriuriFrames, signals and clip window bundle.
reviewer_idstring | nullRequired for path=live on uncertified titles; null for auto-certified. Required on any human override.
partner_idstring | nullPartner identifier. Set by partner on POST /v1/events.
notional_minorintegerNotional in minor units; bps basis on settle.
created_atISO 8601Event creation timestamp.
locked_atISO 8601 | nullPositions closed timestamp.
resolved_atISO 8601 | nullSettlement or hold timestamp.
updated_atISO 8601Last state transition timestamp.
Contract

OpenAPI 3.1 · artifacts/settlement/openapi.yaml

Seven operations. No other verbs exist.

Get agent keyConsole — Keys & billingRead the API