Search tokens by name, symbol or address across every chain
const url = 'https://gib.show/list/search?q=example';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://gib.show/list/search?q=example'Substring match over token name and symbol, plus exact match on address, ranked by how closely the term matches and then by provider ranking. Results are one entry per token, the same shape the chain-scoped endpoints return.
The result set is capped, so this reports whether it was cut (truncated) rather than a total it cannot know. Narrow the term or pass chainId rather than paging — there is no offset parameter, because a cap plus an offset would silently skip matches.
Ranking is always the default ordering; extensions and decimals filters are not accepted.
Parameters
Section titled “Parameters”Query Parameters
Section titled “Query Parameters”Search term. Between 2 and 64 characters; % and _ are matched literally.
Restrict the search to one chain — prefixed form (eip155-369) or bare numeric (369). Narrows the query itself, not just the results.
Maximum tokens to return. Defaults to 100, capped at 1000.
Responses
Section titled “Responses”Matching tokens, best match first.
object
The term as searched, trimmed.
Present only when the search was scoped to one chain (eip155-369).
True when more tokens matched than were returned. There is no total: the query stops at the candidate cap, so a count past that point is not known.
object
Bare numeric chain id (token-list standard). Ambiguous across namespaces — 501 is both Solana and any eip155 chain numbered 501 — so read chainIdentifier when the namespace matters.
Full CAIP-2 identifier the token is stored under (eip155-369, solana-501). Always present on served tokens; it is what disambiguates chainId.
Provider/list keys that include this token, priority order.
Present when requested via ?extensions=.
object
Example generated
{ "query": "example", "chainIdentifier": "example", "truncated": true, "tokens": [ { "chainId": 1, "chainIdentifier": "example", "address": "example", "name": "example", "symbol": "example", "decimals": 1, "logoURI": "example", "sources": [ "example" ], "extensions": {} } ]}Missing q, a term outside the 2–64 character range, or an ambiguous chainId.
object
Example generated
{ "error": "example"}Refresh was requested without a valid admin bearer token (401 also when ADMIN_TOKEN is unset).
object
Example generated
{ "error": "example"}