Skip to content

Search tokens by name, symbol or address across every chain

GET
/list/search
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.

q
required
string

Search term. Between 2 and 64 characters; % and _ are matched literally.

chainId
string

Restrict the search to one chain — prefixed form (eip155-369) or bare numeric (369). Narrows the query itself, not just the results.

limit
integer

Maximum tokens to return. Defaults to 100, capped at 1000.

Matching tokens, best match first.

Media type: application/json
object
query

The term as searched, trimmed.

string
chainIdentifier

Present only when the search was scoped to one chain (eip155-369).

string
truncated

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.

boolean
tokens
Array<object>
object
chainId

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.

integer
chainIdentifier

Full CAIP-2 identifier the token is stored under (eip155-369, solana-501). Always present on served tokens; it is what disambiguates chainId.

string
address
string
name
string
symbol
string
decimals
integer
logoURI
string
sources

Provider/list keys that include this token, priority order.

Array<string>
extensions

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.

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}

Refresh was requested without a valid admin bearer token (401 also when ADMIN_TOKEN is unset).

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}