> ## Documentation Index
> Fetch the complete documentation index at: https://docs.basestonk.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

```bash theme={null}
GET /api/launchpad/tokens?chain=base
```

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

### One token

```bash theme={null}
GET /api/launchpad/tokens/{address}?chain=base
```

### Candles

```bash theme={null}
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

```bash theme={null}
GET /api/launchpad/tokens/{address}/trades?chain=base
```

### Holders

```bash theme={null}
GET /api/launchpad/tokens/{address}/holders?chain=base
```

### A wallet's dividends on a token

```bash theme={null}
GET /api/launchpad/tokens/{address}/rewards/{wallet}?chain=base
```

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

### Venue stats

```bash theme={null}
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](/integration/contracts) for addresses.