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

# API architecture

> The public Go HTTP service and its trust boundary.

The Go API uses chi and PostgreSQL. It serves health/readiness, immutable stored objects, a validated Chainlink ETH/USD reference, metadata draft/finalization writes, and indexed token resources.

All `/api/v1` token list endpoints scope queries to the configured chain ID and canonical, non-excluded application projections. Addresses are normalized as 20-byte hex strings. Cursor pagination is opaque and limited to 100 items; chart queries allow up to 1,000 candles.

The service returns JSON and attaches `X-Request-ID`. Repository failures are logged server-side but returned as a generic `internal_error`, preventing internal database details from leaking.

<Note>
  The repository does not define API authentication or a published service-level commitment for these public reads. Integrators should handle timeouts, unavailable oracle data, and indexing lag.
</Note>

See [API overview](/docs/api-reference/overview) for every routed endpoint.