# GET /v4/tokens/

_Merkl API_

Search tokens, or resolve several ids at once with `?id=` (canonical numeric ids only). An address the database does not know, passed as `?chainId={chainId}&search={address}`, is read from chain and returned with a temporary `tmp-{chainId}-{address}` id. That temporary id is not accepted back on `GET /v4/tokens/{id}`, which answers 400.

### Query parameters

- `page` (string | number)
- `items` (string | number)
- `id` (array)
- `symbol` (string)
- `displaySymbol` (string)
- `chainId` (string | number)
- `isNative` (boolean)
- `address` (string)
- `name` (string)
- `search` (string)
- `verified` (boolean)
- `test` (boolean)
- `missingIcons` (boolean)
- `missingPrice` (boolean)

## Example request

```bash
curl -X GET "https://api.merkl.xyz//v4/tokens/" \
  -H "x-api-key: YOUR_API_KEY"
```