> ## 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.

# Manager API

> The read API behind the app — public, vault-scoped, observer-friendly.

The app is a client of a public **read API** served by the manager (the off-chain side of the agent). It exists so the app — and anyone building a dashboard or integration — can read indexed vault state without running their own indexer.

<Note>
  The API is read-only for vault data. It cannot act on any vault: all actions are wallet signatures, and the agent's own decision endpoints are not public. Base URL is published at launch.
</Note>

## Principles

* **Vault-scoped, always.** Every per-vault endpoint answers for exactly the vault in the path. Unknown vaults return empty shapes, never aggregates. This is what makes shareable observer links safe.
* **Derived from chain events.** The API serves the indexed form of the [contract events](/reference/contracts/events) plus manager-side context (scheduler state, status derivation). Anything important is verifiable against the chain.
* **Honest nulls.** Figures without a ratified data source (e.g. live APR early on) are `null`, rendered as "—" in the app. The API does not fabricate numbers.
* **USD as floats, timestamps as unix seconds.**

## Endpoint groups

| Group                                            | What it serves                                                                   |
| ------------------------------------------------ | -------------------------------------------------------------------------------- |
| Registry                                         | Resolve an owner address to their vault                                          |
| [Strategies](/reference/api/strategies)          | The strategy catalogue with live pool composition                                |
| Universe                                         | The current asset/pair screen output (what BYO can pick from)                    |
| [Snapshot & positions](/reference/api/positions) | A vault's live state: value, positions, ranges, fee books, status                |
| Equity                                           | Time series of vault value and capital flows, for charting                       |
| Events                                           | The vault's activity ledger, filterable by type and time                         |
| [Exit quote](/reference/api/fee-projection)      | The fee projection for a proposed withdrawal                                     |
| Settings                                         | Owner preferences (compound behaviour, exit asset) — the one authenticated write |

## Authentication

Reads are public. The single write surface (settings) is owner-authenticated by wallet signature — a signed session proves you control the vault's owner address. Observer links carry no session and therefore can never act.