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

# Tokens

> Token lists, details, pricing, chart data, creators, and holdings.

## Lists and details

`GET /api/v1/tokens` and `/api/v1/tokens/newest` accept `limit` (default 20, range 1–100), an opaque `cursor`, optional `search`, or optional `view`. `search` and `view` cannot be combined.

`GET /api/v1/tokens/{address}` returns identity, metadata, creation provenance, curve state, metrics, and optional graduation data. `indexed_through_block` identifies the canonical checkpoint for the snapshot.

## Pricing

`GET /api/v1/tokens/{address}/pricing` returns:

```json theme={null}
{
  "token_address": "0x1111111111111111111111111111111111111111",
  "current_price": "36225000000000",
  "fully_diluted_value": "36225000000000000000000",
  "source": "indexed_v3_curve"
}
```

The values are illustrative. `source` becomes `indexed_v3_market` only for a graduated token whose latest indexed trade source is `uniswap_v3`.

## Chart

`GET /api/v1/tokens/{address}/chart?interval=1h&limit=168&from=...&to=...`

Intervals: `1m`, `5m`, `15m`, `1h`, `4h`, `1d`, `1w`. Limit defaults to 168 and ranges from 1–1000. `from` and `to` are non-negative Unix seconds with a half-open `[from,to)` interpretation; `from` must be earlier than `to`.

## Creators and holdings

* `GET /api/v1/creators/{address}`
* `GET /api/v1/creators/{address}/tokens`
* `GET /api/v1/wallets/{address}/holdings`

These accept standard cursor pagination. Holdings include raw 18-decimal token balance, lifecycle, nullable price/value, and indexed metrics. Examples are data shapes, not live balances.