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

# Snapshot & positions

> A vault's live state in one shape.

## `GET /vault/:address/snapshot`

The one shape the dashboard is built from. Highlights:

```json theme={null}
{
  "vault": "0x…",
  "owner": "0x…",
  "status": "earning",
  "strategy": "bluechip",
  "valueUsd": 12840.55,
  "capitalInUsd": 10000.0,
  "capitalOutUsd": 0.0,
  "netUsd": 2840.55,
  "strategyDeltaUsd": 610.22,
  "marketDeltaUsd": 2230.33,
  "positions": [
    {
      "id": "421",
      "pool": { "a": "WETH", "b": "USDG", "venue": "…", "feeTier": 3000 },
      "range": { "lower": 2410.5, "upper": 3120.8, "current": 2745.1 },
      "inRange": true,
      "pendingRewardsUsd": 14.02
    }
  ],
  "fees": {
    "contributedUsd": 10000.0,
    "withdrawnUsd": 0.0,
    "taxedUsd": 0.0,
    "highWaterUsd": 10000.0
  },
  "suspension": null,
  "updatedAt": 1757000000
}
```

Semantics worth knowing:

* **`status`** — `idle` (no capital) · `planting` · `earning` (all in range) · `attention` (≥1 position out of range) · `exiting` · `suspended`.
* **`netUsd = valueUsd + capitalOutUsd − capitalInUsd`** — deposits can never appear as gains.
* **`strategyDeltaUsd` + `marketDeltaUsd` always sum to `netUsd`** — the agent's contribution and the market's, kept separate by construction.
* **`positions[].range` is in price space** (human prices, decimals-adjusted), not raw ticks.
* **`suspension`**, when non-null, carries the reason and confirms `exitsAvailable: true`.

## `GET /vault/:address/equity`

Time series of `{ ts, valueUsd, capitalInUsd, capitalOutUsd }` for charting, downsampled server-side. Chart deltas are computed **net of flows** — a deposit is not a rally.

## `GET /vault/:address/events`

The activity ledger, newest first, filterable by `type`, `since`, `until`, `limit`. Each row carries its transaction hash. See [Events](/reference/contracts/events) for the vocabulary.