API · irl.macropulse.live · TLS · PostgreSQL

IRL Engine
Developer Sandbox

Cryptographic pre-execution compliance gateway for autonomous trading agents. Every authorize call seals the agent's reasoning with SHA-256 before the order reaches the exchange. Three demo agents are pre-seeded — no registration required to try the API.

Three calls, full audit chain

Use a demo agent_id below. No API key required for the public sandbox.

1
Authorize — seal the reasoning before the order
Returns reasoning_hash + trace_id. Embed both in the exchange order metadata.
# POST /irl/authorize
# Header: Authorization: Bearer <token>
{
  "trace_id": "<uuid-v4>",
  "agent_id": "00000000-0000-4000-a000-000000000001",
  "action": { "Long": 1.5 },
  "asset": "BTC/USD",
  "order_type": "Market",
  "quantity": 1.5,
  "client_order_id": "ord-001",
  "heartbeat_seq": 1,
  "policy_id": "default",
  "policy_version": "1.0"
}
# → { "reasoning_hash": "sha256...", "trace_id": "...", "policy_result": "ALLOWED" }
2
Execute — submit to exchange, get tx_id back
The agent sends the order. The exchange returns an execution report. IRL is not in this path — the agent acts autonomously.
3
Bind — close the chain with final_proof
IRL computes final_proof = SHA-256(reasoning_hash ‖ exchange_tx_id). Chain closed — verifiable by any auditor.
# POST /irl/bind-execution
{
  "trace_id": "<same uuid from step 1>",
  "exchange_tx_id": "exch-abc-123",
  "execution_status": "FILLED",
  "execution_price": 43250.00
}
# → { "final_proof": "sha256...", "verification_status": "MATCHED" }

API Reference

Full schema + try-it-out in Swagger UI. OpenAPI 3.1 JSON for Postman / SDK generators.

Pre-seeded sandbox agents

Use any of these agent_ids in POST /irl/authorize. All are Active, max_notional 10,000, allowed regimes 0–2.

Use caseagent_idStatus
Crypto 00000000-0000-4000-a000-000000000001 Active
Equities 00000000-0000-4000-a000-000000000002 Active
Futures 00000000-0000-4000-a000-000000000003 Active