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

# API overview

> Base URL, common conventions, and endpoint reference.

Base URL: `https://api.testnet.topokki.exchange`

The Topokki API provides current swap quotes, display prices, and testnet configuration. It is public and returns JSON.

<Warning>
  This is a testnet API. Quotes and prices can change quickly. Request a fresh quote before every swap.
</Warning>

## Conventions

* All token addresses are EVM addresses.
* Token amounts are raw integer strings. For example, `1000000` is `1` USDC when the token has 6 decimals.
* Quote requests use GIWA Sepolia chain ID `91342`.
* A successful request returns `200`. Invalid inputs return `400`; a request that cannot be quoted returns `422`.

## Endpoints

<CardGroup cols={2}>
  <Card title="Get a swap quote" icon="arrow-right-left" href="/developers/endpoints/quote">
    Get a fresh exact-input or exact-output route.
  </Card>

  <Card title="Get token prices" icon="badge-dollar-sign" href="/developers/endpoints/prices">
    Get WETH and token display prices in USD and KRW.
  </Card>

  <Card title="Check API status" icon="activity" href="/developers/endpoints/status">
    Read health, network configuration, and transaction status.
  </Card>

  <Card title="Use with Viem" icon="code-2" href="/developers/viem-swaps">
    Execute direct V2 or smart-order-routed swaps.
  </Card>
</CardGroup>