Core

post/irl/bind-execution

Request

  • Base URL: https://irl.macropulse.live (the document declares no server; this is the origin it was published from)
  • URL: https://irl.macropulse.live/irl/bind-execution
  • Auth: HTTP bearer

Request body

assetstring nullable

Asset actually traded (for mismatch detection).

exchange_tx_idstring required
executed_quantitynumber double nullable

Quantity actually executed (for tolerance check).

executed_sidestring nullable

Trade direction as reported by the exchange: "Long" or "Short". Optional — if provided, verified against the authorized intent to detect side mismatches (e.g. Long authorized but Short executed). Omit if the exchange does not return direction in the fill report.

execution_pricenumber double nullable

Execution price at the exchange (for forensic PnL correlation).

execution_statusExecutionStatus required(unresolved $ref)
execution_time_msinteger nullable

Unix milliseconds of the actual exchange fill. Optional — if provided, stored as execution_time for accurate PnL timestamps. Defaults to IRL wall clock at bind time if not supplied.

trace_idstring uuid required

Response

Bound — final_proof computed

divergence_reasonstring nullable

Non-None when verification_status is Divergent — explains what differed.

execution_statusstring required
execution_timestring date-time required
final_proofstring required

SHA-256(reasoning_hash || "||" || exchange_tx_id). This is the terminal proof that closes the chain: Agent Reasoning → IRL Snapshot → Exchange Order

trace_idstring uuid required
verification_status'Pending' | 'Matched' | 'Divergent' | 'Orphan' | 'Expired' | 'Mismatch' required

Full lifecycle of a reasoning trace — whitepaper v3 §11.2.

Changes

No recorded changes to this operation across all 1 revision of this API.