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.