← Back to docs

Public API

A read-only JSON API for everything public on Waves. Build dashboards, bots, trackers or anything that sits on top of the engines. No key needed, and browsers can call it directly.

Open /api/v1 ↗ Try /api/v1/stats

Base URL

/api/v1

Every response is JSON. SOL amounts are plain decimal numbers and token amounts are whole units, so format them yourself instead of trusting any display.

What you can build

Leaderboards for burned supply, claimed fees or rewards paid
Bots that watch cycle logs and post every burn or payout
Custom token pages and portfolio tools
Analytics across every vault without scraping the site

Endpoints

GET/api/v1

Index. Lists every endpoint.

GET/api/v1/stats

Platform totals: token count, fees claimed, burned supply, rewards paid, cycles run and a count per engine.

GET/api/v1/tokens

Every token. Optional query: engine and limit (1 to 100).

/api/v1/tokens?engine=burn&limit=20

GET/api/v1/tokens/:mint

One token: engine, vault, totals, recent cycles and links.

/api/v1/tokens/MINT_ADDRESS

GET/api/v1/tokens/:mint/cycles

The cycle log for one token. Optional query: limit (1 to 100).

/api/v1/tokens/MINT_ADDRESS/cycles?limit=40

Quick examples

curl https://YOUR_DOMAIN/api/v1/stats
curl https://YOUR_DOMAIN/api/v1/tokens
curl "https://YOUR_DOMAIN/api/v1/tokens?engine=burn"
curl https://YOUR_DOMAIN/api/v1/tokens/MINT_ADDRESS/cycles

Rules

Rule	Detail
Read only	There is no endpoint that launches a token or touches a vault.
No keys	No API key, and no private key is ever part of a response.
Open to browsers	CORS is open, so a web app can call it directly.
Cache	Responses can be cached for about 30 seconds. Please do not hammer it.
Engine values	deepen, burn, staking, holders