Execution Readiness API
Execution Decide is the go/no-go LyraMind renders before money moves. It composes the Agent Readiness gate, a deterministic notional policy, and provider routing into one decision, recorded to the Trust Ledger. It orchestrates, never executes.
What it returns
The response returns a decision (PROCEED, READY, WAIT, REVIEW, NOT_READY, or HIGH_RISK), boolean clear_to_execute, requires_confirmation, and blocked flags, the normalized action, a reasons list, a controls block (thresholds and applied controls), the grounding intelligence summary, a providers block of eligible executors, the trust envelope, and an accountability block with the ledger_id.
The action body accepts type, capability (payment, fx, treasury, custody, debt, equity, or brokerage), amount, currency, and counterparty, all optional, plus an optional symbol.
When to use it
Call Execution Decide before an agent or platform executes a money-moving action. When a symbol is given the Agent Readiness gate grounds the decision; without one it is policy-only and requires human confirmation. The notional policy escalates by size: above the auto-execute limit needs confirmation (READY), and at or above the dual-control threshold needs two-person REVIEW.
Missing or invalid inputs degrade honestly to WAIT rather than guessing.
Notes and honesty
The decision is fail-safe by design: any single blocking condition holds, and policy can only escalate toward caution, never wave an action through. This is a control and gate, never a buy or sell recommendation. LyraMind does not move funds or custody assets; the eligible providers are the connected executors that could, and every decision is recorded to the Trust Ledger.
- decision: PROCEED, READY, WAIT, REVIEW, NOT_READY, or HIGH_RISK
- clear_to_execute, requires_confirmation, blocked flags
- controls: auto-execute and dual-control thresholds applied
- intelligence: the grounding readiness verdict and factors
- providers.eligible: connected executors that could run it
- accountability.ledger_id: the recorded decision
curl -s https://api.lyramindos.com/v1/execution/decide -H 'Content-Type: application/json' -H 'x-api-key: YOUR_KEY' -d '{"symbol":"AAPL","action":{"type":"buyback","capability":"treasury","amount":500000,"currency":"USD"}}'Questions
Does LyraMind execute the action?
No. It renders the execution-readiness decision and routes to connected providers that could execute. It never moves funds or custodies assets; the boundary is explicit and recorded.
How does size affect the decision?
The notional policy escalates by amount: above the auto-execute limit requires human confirmation (READY), and at or above the dual-control threshold requires two-person REVIEW. Missing amounts degrade to WAIT.
Is this financial advice?
No. It is a control gate deciding whether an action is safe and authorized to execute, and who could execute it, never a buy or sell recommendation.