Lagoon API

Off-chain GraphQL API exposing vault state, user positions, and event history across all supported chains.

The Lagoon API is a single multi-chain GraphQL endpoint that returns indexed vault data — current state, historical state, user positions, the full event stream, and reference data such as chains, assets, curators, and integrators.

POST https://api.lagoon.finance/query
Content-Type: application/json

Reads are public; no API key is required.

Quickstart

Confirm connectivity and check indexing health for every chain in one call:

{
  _meta {
    lastIndexedBlocks {
      chainId
      number
      hash
      chain { name }
    }
  }
}

Try in Apollo Sandbox →

Same query as a curl call:

curl -sS -X POST https://api.lagoon.finance/query \
  -H "Content-Type: application/json" \
  -d '{"query":"{ _meta { lastIndexedBlocks { chainId number hash chain { name } } } }"}'

_meta.lastIndexedBlocks returns the most recent tracked block per chain. An hourly health-check event guarantees the value advances at least once per hour even on quiet chains — if a chain is more than ~1 hour behind, the indexer is lagging.

Open https://api.lagoon.finance/query in a browser to launch Apollo Sandbox, an interactive schema explorer. Introspection is enabled, so the full schema (types, fields, descriptions) is browsable without any client setup — Sandbox is the authoritative reference for every field name in this documentation. Throughout these docs, "Try in Apollo Sandbox" links open Sandbox with the example query already populated in the Operation panel.

Where to go next

Common queries

Recipes for the queries integrators reach for first — list vaults, fetch a vault, get a user's positions, stream events, read historical state, global TVL.

Conventions

Pagination, filtering, ordering, scalar formats, and how to query historical data and indexing health.

Mutations

The single mutation today — updating off-chain vault metadata with an EIP-712 signature from the vault owner.

Smart Contract Reference

On-chain counterpart to this API — every external entry point on the v0.6.0 vault implementation.