get

/v4/tokens/

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

pagestring (integer) | integerdefault: 0

0-indexed page number

itemsstring (integer) | integerdefault: 20

Number of items returned by page

idstring[]

Filter by token IDs, canonical numeric hash only. The {chainId}-{address} shorthand is path-only: use GET /v4/tokens/{id} for it. See ID types.

symbolstring

Filter by token symbol (e.g. USDC).

displaySymbolstring

Filter by token display symbol.

chainIdstring (integer) | integer

Chain ID (numeric, e.g. 1 for Ethereum).

isNativeboolean

addressstring

20-byte EVM token address. Combine with chainId for a unique result.

namestring

searchstring

verifiedboolean

testboolean

missingIconsboolean

missingPriceboolean

get

https://api.merkl.xyz/v4/tokens/?page=&items=

Merkl API

curl -X GET "https://api.merkl.xyz/v4/tokens/?page=0&items=20"