> For the complete documentation index, see [llms.txt](https://docs.kumbaya.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kumbaya.xyz/developers/apis/exchange-api/stats.md).

# Stats endpoints

Global aggregate stats across the Kumbaya DEX. All endpoints are `GET` and **public** (no auth).

| Endpoint                     | Purpose                                                       |
| ---------------------------- | ------------------------------------------------------------- |
| `GET /api/v1/stats/global`   | Global TVL, 24h volume, fees, and timeseries                  |
| `GET /api/v1/indexer/status` | Envio indexer sync progress (height, lag, last block indexed) |

## Token-level stats

Token-level data lives under `/api/v1/tokens/*`:

| Endpoint                               | Purpose                                                           |
| -------------------------------------- | ----------------------------------------------------------------- |
| `GET /api/v1/tokens/trending`          | Trending tokens by recent activity                                |
| `GET /api/v1/tokens/{tokenId}`         | Token overview (name, symbol, price, TVL, launchpad metadata)     |
| `GET /api/v1/tokens/{tokenId}/history` | Price/TVL timeseries (`timeframe` ∈ `days` / `hours` / `minutes`) |
| `GET /api/v1/tokens/bluechip`          | Verified/trusted token list                                       |
| `GET /api/v1/tokens/prices`            | Batch token prices (up to 100 addresses)                          |
| `GET /api/v1/tokens/fire-meta`         | Launchpad-specific metadata for tokens                            |

`tokenId` is the indexer's `address-chainId` composite.

## Other helpers

| Endpoint                                     | Purpose                                                                |
| -------------------------------------------- | ---------------------------------------------------------------------- |
| `GET /api/v1/users/{owner}/positions/active` | Active LP positions for a wallet address                               |
| `GET /api/v1/status?chainId=&txHash=`        | Swap-execution status for a tx hash (`pending` / `success` / `failed`) |
| `GET /api/health`                            | Liveness probe                                                         |

For exact request/response shapes see the Swagger UI at [**`exchange.kumbaya.xyz/docs`**](https://exchange.kumbaya.xyz/docs).