Snapshot & positions

`GET /vault/:address/snapshot`

The one shape the dashboard is built from. Highlights:

{
  "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 for the vocabulary.

Contracts

Manager API

Security

Snapshot & positions

`GET /vault/:address/snapshot`

`GET /vault/:address/equity`

`GET /vault/:address/events`

​GET /vault/:address/snapshot

​GET /vault/:address/equity

​GET /vault/:address/events

`GET /vault/:address/snapshot`

`GET /vault/:address/equity`

`GET /vault/:address/events`