Docs · API

Public API

A read-only HTTP API for everything public on HoodPad. Build dashboards, bots, indexers, or anything that sits on top of the fee engines. No API key, CORS open.

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

Base URL

https://hoodpad.gg/api/v1

All responses are JSON. Amounts from the chain are returned as decimal strings in wei or raw token units, so convert them yourself rather than trusting anyone's display formatting.

What you can build

Boards for live curves vs graduated pools
Bots that watch new TokenLaunched events
Custom token pages and portfolio tools
Analytics over every launch without scraping the website

Endpoints

GET/api/v1

API index. Lists available endpoints.

GET/api/v1/stats

Platform totals: token count, claimed fees, buybacks, burned supply, rewards, strategy breakdown.

GET/api/v1/tokens

All active tokens. Optional query: strategy, limit.

/api/v1/tokens?strategy=buyback_burn&limit=20

GET/api/v1/tokens/:address

One token: Pons v2 launch state, curve progress, explorer links.

/api/v1/tokens/0xcb5990596341d0260522cddf7a0a0e8c8187c62d

GET/api/v1/tokens/:address/cycles

Cycle log for one token. Optional query: limit (max 100).

/api/v1/tokens/0xcb5990596341d0260522cddf7a0a0e8c8187c62d/cycles?limit=40

Quick examples

List tokens

curl https://hoodpad.gg/api/v1/tokens

Platform stats

curl https://hoodpad.gg/api/v1/stats

Official token

curl https://hoodpad.gg/api/v1/tokens/0xcb5990596341d0260522cddf7a0a0e8c8187c62d

Filter by strategy

curl "https://hoodpad.gg/api/v1/tokens?strategy=buyback_burn"

Rules

Read-only. There is no write endpoint for launches.
CORS is open (*), so browser apps can call the API directly.
Responses are cacheable for about 30 seconds. Please do not hammer the endpoints.
Locked liquidity uses strategy=liquidity. Buyback and burn uses buyback_burn. Staking uses staking. Holder dividends use holder_rewards.