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

# Get token prices

> Get testnet display prices for one or more token contracts.

`GET /v1/price` · `GET /v1/prices` · `POST /v1/prices`

Prices include USD and KRW display values. WETH is priced from a native ETH spot source; other tokens are estimated from current AMM liquidity.

## Get one price

```bash theme={null}
curl 'https://api.testnet.topokki.exchange/v1/price?address=0x4200000000000000000000000000000000000006'
```

## Get several prices

```bash theme={null}
curl 'https://api.testnet.topokki.exchange/v1/prices?addresses=0x4200000000000000000000000000000000000006,0x01a24d6f238c29d4bebc2ac40f56723f4f8e83d2'
```

Or send an array of up to 50 addresses:

```bash theme={null}
curl -X POST 'https://api.testnet.topokki.exchange/v1/prices' \
  -H 'content-type: application/json' \
  --data '[
    "0x4200000000000000000000000000000000000006",
    "0x01a24d6f238c29d4bebc2ac40f56723f4f8e83d2"
  ]'
```

## Response

```json theme={null}
{
  "chainId": 91342,
  "cacheTtlMs": 1000,
  "asOf": "2026-07-24T06:42:14.935Z",
  "native": {
    "usd": 1886.225,
    "krw": 2765927.9533508066,
    "source": "coinbase"
  },
  "prices": [
    {
      "address": "0x4200000000000000000000000000000000000006",
      "symbol": "WETH",
      "decimals": 18,
      "usd": 1886.225,
      "krw": 2765927.9533508066,
      "source": "coinbase"
    }
  ],
  "errors": []
}
```

An unavailable token does not discard successful results for the other tokens. It is listed in `errors` instead.

<Warning>
  Prices are for display only. Do not use them as a settlement, lending, collateral, or liquidation oracle.
</Warning>