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

# Search tokens and read wallet data

> Three public endpoints. No API key needed.

## Search tokens

```bash theme={null}
curl 'https://api.route.fun/api/v2/tokens/search?query=USDG&limit=10'
```

Search matches listed names and symbols. Use an exact contract address to look up an unlisted token. This is not a chain-wide index.

## Read balances

```bash theme={null}
curl "https://api.route.fun/api/v2/wallets/$WALLET_ADDRESS/balances"
```

Returns nonzero balances for listed tokens. Add `?token=0x...` to include one extra token. Values are integer base units; `failed` counts unsuccessful token reads.

## Check a transaction

```bash theme={null}
curl "https://api.route.fun/api/v2/transactions/$TRANSACTION_HASH"
```

Status is `not_found`, `pending`, `confirmed` or `reverted`. Check `finalized` separately. A missing transaction is not proof it was never sent. This endpoint reports chain status, not whether a swap met your application's expectations.

Search and status allow 60 requests/minute per caller; balances allow 30. Shared capacity also applies. Respect `Retry-After` on 429 responses.