REST API

Every token, trade, candle and holder - the indexer’s numbers, served.

Base URL: https://api.basestonk.io

The API serves what BaseStonk’s own interface reads. No key, no auth. BaseStonk pools are Uniswap v4 pools, so raw-chain integrations that assume v2/v3 pair contracts will read $0 liquidity - the API has already done the v4 accounting for you.

Endpoints

List every token

GET /api/launchpad/tokens?chain=base

Returns every launch with pair, hook, price, market cap, volume, holder count and tax shape.

One token

GET /api/launchpad/tokens/{address}?chain=base

Candles

GET /api/launchpad/tokens/{address}/candles?interval=1m&chain=base

Intervals: 1s, 5s, 15s, 1m, 5m, 15m, 1h. Unknown values fall back to 5m.

Trades

GET /api/launchpad/tokens/{address}/trades?chain=base

Holders

GET /api/launchpad/tokens/{address}/holders?chain=base

A wallet’s dividends on a token

GET /api/launchpad/tokens/{address}/rewards/{wallet}?chain=base

Received so far, plus the live pending amount from the distributor.

Venue stats

GET /api/launchpad/stats/base

Totals across the venue: tokens, trades, volume, holders.

Watching the chain directly

New launches emit AdvancedLaunched from the launcher contracts, carrying the pair token and the opening sqrtPriceX96 directly - everything needed to construct the pool key and start indexing from the first block. See contracts for addresses.