> ## Documentation Index
> Fetch the complete documentation index at: https://docs.superform.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Intent History

> Trace Strategy Engine intents through OMS events, fills, gas, and execution status.

<img src="https://mintcdn.com/superform-cb7ef652/MhEzTvzQXPC-eNn0/operate/images/screenshots/history.jpg?fit=max&auto=format&n=MhEzTvzQXPC-eNn0&q=85&s=d5613cf881e4ac01e9414b8489781add" alt="SuperformOS Intent History - read-only strategy execution ledger" width="1600" height="930" data-path="operate/images/screenshots/history.jpg" />

Intent History is the operator-facing execution explorer for Strategy and OMS activity. Use it to answer: what strategy fired, where the intent is in the lifecycle, what filled, what transaction mined, and why execution failed.

## What it shows

| View | Use it for |
| - | - |
| Intent list | Search and filter intents across vaults and strategies. |
| Facets | Count by state, action, chain, vault, and strategy. |
| Lifecycle strip | See the current OMS lifecycle state and timestamps. |
| Fills table | Inspect per-fill venue, token in/out, amounts, gas, fees, and fill time. |
| OMS events | Audit message type, sequence, payload, and source. |
| Signal snapshot | See the Strategy Engine signal context that produced the intent. |

## Lifecycle states

The explorer uses the OMS lifecycle vocabulary:

`RECEIVED`, `ACKED`, `STAGED`, `PLANNED`, `EXECUTING`, `COMPLETED`, `ABORTED`, `EXPIRED`, `FAILED`, `CANCELED`, and `UNKNOWN` for rows that cannot be normalized.

## How it maps to OMS

The Strategy Engine projects OMS events and backfills into `strategy_intent_log`. Each row can include:

* `intent_id`, `execution_id`, `correlation_id`
* strategy and vault IDs
* last event sequence and message type
* ack/executing/completed/terminal timestamps
* error code and message
* total amount in/out
* total gas used
* fills count
* signal snapshot and summary
* source: `engine`, `nats`, or `backfill`

## API mapping

| Endpoint | Purpose |
| - | - |
| `GET /api/v1/intents` | Global intent search. |
| `GET /api/v1/intents/facets` | Facet counts for filters. |
| `GET /api/v1/intents/{intent_id}` | Intent detail. |
| `GET /api/v1/intents/{intent_id}/fills` | Fills for one intent. |
| `GET /api/v1/intents/{intent_id}/events` | OMS event audit rows. |
| `GET /api/v1/fills` | Global fill search. |

## Common reads

| Symptom | Check |
| - | - |
| Intent never mined | Look at `EXECUTING` events, hook transaction fields, and gas budget. |
| Intent completed with no visible position change | Check fills and amount out fields; some fields can be `null` until OMS hydration completes. |
| Strategy appears blocked | Check emergency locks, kill switch, session-key readiness, and merkle proof availability. |
| Duplicate-looking rows | Compare `intent_id`, `execution_id`, and `correlation_id`; retries and backfills can share context. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.