---
title: "GET /irl/trace/{trace_id}"
method: GET
path: "/irl/trace/{trace_id}"
tags: ["Traces"]
---

# GET /irl/trace/{trace_id}

`GET /irl/trace/{trace_id}`

## 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/trace/{trace_id}`
- Auth: HTTP bearer

## Path parameters

- `trace_id` string, uuid, required

## Response `200`

Reasoning_Trace_v1

- ReasoningTrace: The full Reasoning_Trace_v1 object returned to callers and stored in DB.
  - `agent` AgentBlock, required
    - `agent_id` string, uuid, required
    - `feature_schema_id` string, required
    - `latent_fingerprint` string, required
  - `bitemporal` BiTemporalBlock, required
    - `time_source` string, required
    - `txn_time` string, date-time, required
    - `valid_time` string, date-time, required
  - `execution` ExecutionBlock, required
    - `action` string, required
    - `asset` string, required
    - `client_order_id` string, required
    - `limit_price` number, double, nullable
    - `multiplier` number, double, required
    - `notional` number, double, required
    - `notional_currency` string, required
    - `order_type` string, required
    - `quantity` number, double, required
    - `stop_price` number, double, nullable
    - `venue_id` string, required
  - `heartbeat` HeartbeatBlock, required
    - `drift_ms` integer, required
    - `sequence_id` integer, required
    - `signature_valid` boolean, required
  - `integrity` IntegrityBlock, required
    - `execution_status` string, nullable
    - `final_proof` string, nullable
    - `reasoning_hash` string, required
    - `verification_status` string, required
  - `mta` MtaBlock, required
    - `allowed_sides` string[], required: Trade directions that were permitted.
    - `hash` string, required
    - `max_notional_scale` number, double, required: Regime-level notional multiplier that was in effect.
    - `regime_id` integer, required
    - `regime_label` string, required
    - `risk_level` number, double, required: Normalized risk level at time of decision (0.0–1.0).
    - `signature_valid` boolean, required
    - `version` string, required
  - `policy` PolicyBlock, required
    - `hash` string, required
    - `id` string, required
    - `result` string, required
    - `version` string, required
  - `regulatory` RegulatoryBlock: Optional regulatory metadata — included when the agent operates under a reporting regime that requires structured fields in the audit trace. All fields are optional. The block itself is absent (`None`) when no regulatory context is provided by the agent. MiFID II (EU): algorithmic trading identifier + decision-maker identity. CFTC (US): Commodity Trading Advisor Code + special account code. SEC/FINRA: optional order-tracking reference number (CAT NMS). IRL seals and persists whatever the agent supplies — it does not validate against any external regulatory schema. Compliance teams are responsible for verifying that the values satisfy their specific reporting obligations.
    - `cat_order_id` string, nullable: SEC CAT NMS: Consolidated Audit Trail order-tracking reference number.
    - `cftc_account_type` string, nullable: CFTC: special account type designator (e.g. "H" = hedge, "S" = speculator).
    - `cftc_cti_code` string, nullable: CFTC: Commodity Trading Advisor (CTA) code for the account.
    - `jurisdiction` string, nullable: Free-form jurisdiction tag (e.g. "EU", "US", "UK", "APAC"). Allows downstream compliance tooling to route the trace for the right rulebook.
    - `mifid_algo_id` string, nullable: MiFID II Annex I Table 2: algorithm identifier assigned by the firm. Required for algorithmic orders under Art. 17 of MiFID II.
    - `mifid_decision_maker` string, nullable: MiFID II: identifier of the person or system that made the investment decision.
  - `trace_id` string, uuid, required
  - `version` string, required

## Other responses

- `404`: Trace not found

---

[API](https://skmtc.dev/macropulse/apis/irl-engine.md) · [All operations](https://skmtc.dev/macropulse/apis/irl-engine/llms.txt) · [OpenAPI document](https://skmtc.dev/macropulse/apis/irl-engine/revisions/5226e22ddd17?raw)