> ## 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.

# API overview

> Cooket's implemented HTTP resources and data conventions.

The canonical API origin is `https://api.cooket.fun`. The repository implements these routes; this page does not assert current endpoint health.

```shell theme={null}
curl "https://api.cooket.fun/api/v1/tokens?limit=20"
```

| Method | Path                                             | Purpose                                 |
| ------ | ------------------------------------------------ | --------------------------------------- |
| GET    | `/health`, `/readyz`                             | Process liveness and database readiness |
| GET    | `/objects/*`                                     | Stored public image or JSON object      |
| POST   | `/api/v1/token-metadata`                         | Create a metadata draft                 |
| POST   | `/api/v1/token-metadata/{draft}/finalize`        | Bind metadata to an indexed launch      |
| GET    | `/api/v1/tokens`, `/api/v1/tokens/newest`        | List, filter, or search tokens          |
| GET    | `/api/v1/tokens/trending`, `/api/v1/trending`    | Trending token aliases                  |
| GET    | `/api/v1/tokens/{address}`                       | Token detail                            |
| GET    | `/api/v1/tokens/{address}/pricing`               | Current indexed price and FDV           |
| GET    | `/api/v1/tokens/{address}/chart`                 | Indexed OHLC candles                    |
| GET    | `/api/v1/tokens/{address}/trades`                | Indexed trades                          |
| GET    | `/api/v1/tokens/{address}/activity`              | Canonical decoded events                |
| GET    | `/api/v1/creators/{address}`                     | Creator profile                         |
| GET    | `/api/v1/creators/{address}/tokens`              | Creator tokens                          |
| GET    | `/api/v1/wallets/{address}/holdings`             | Indexed positive balances               |
| GET    | `/api/v1/tokens/{address}/cto*`, `/api/v1/cto/*` | Read-only CTO projections               |

All JSON responses carry `X-Request-ID`. Financial amounts are decimal integer strings. Treat cursors as opaque and reuse them only with the same resource/query. Indexed responses can lag Arc receipts.