Reference

API

Public, read-only JSON. Base URL: https://. Limit: 40 requests per second per IP.

Example

curl "https://<indexer-host>/v1/launches?sort=gainers&window=1h"

Endpoint	Returns
`GET /v1/status`	Indexed block, chain head and lag
`GET /v1/stats`	Totals and hourly activity
`GET /v1/launches?q=&sort=&limit=&before=`	Launches, newest first. `before` takes the last row's `created_at:block:token`
`GET /v1/launches?sort=gainers&window=`	Gainers. Window: 5m, 1h, 6h or 24h
`GET /v1/explore?sort=&page=&q=&stage=&fee_min=&mcap_min=...`	Filtered list, 50 rows per page, with `total`
`GET /v1/trades?limit=`	Latest trades on all tokens
`GET /v1/leaderboard?window=&board=&page=`	Board: traders, creators or snipers. 25 rows per page

Endpoint	Returns
`GET /v1/tokens/{address}`	One token, with its image, description and links
`GET /v1/tokens/{address}/trades?limit=&before=`	Trades, newest first. `before` takes `block:log_index`
`GET /v1/tokens/{address}/candles?res=&unit=`	OHLC. res in seconds: 1, 5, 15, 60, 300, 900, 3600. unit: hype or usd
`GET /v1/tokens/{address}/holders`	Holder count and concentration

Endpoint	Returns
`GET /v1/accounts/{address}/positions?page=`	Positions and realized flows
`GET /v1/accounts/{address}/fees?page=`	Creator fees by token

Paged responses have the shape { rows, total, page, page_size }.

Connect to /v1/stream over WebSocket. Each message has one of these shapes:

Field	Meaning
`launches, trades, buybacks`	A batch of new events
`hypeUsd`	Current HYPE price, or null when stale
`meta`	Details resolved for a launch made outside the app
`reset`	The chain reorganized. Load the snapshot again

After reconnecting, load the snapshot again.