All deduplicated tokens for a chain, ranked by list priority
const url = 'https://gib.show/list/tokens/eip155-369?limit=50000&format=compact&fields=address%2Cname%2Csymbol%2Cdecimals%2Csources&refresh=1';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/tokens/eip155-369?limit=50000&format=compact&fields=address%2Cname%2Csymbol%2Cdecimals%2Csources&refresh=1'Responses carry cache-control: public, max-age=21600, stale-while-revalidate=86400 (6 hours fresh, 24 hours stale); top chains are kept perpetually warm. Each token carries sources[] showing which lists include it.
Authorizations
Section titled “Authorizations”- None
- adminBearer
Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Chain identifier — prefixed form (eip155-369) or bare numeric (369). Chain 0 uses the asset namespace (asset-0). Algorand ARC-25 ids 4160 and 416001 (bare or eip155-) are aliases of algorand-283.
Query Parameters
Section titled “Query Parameters”Maximum tokens returned, clamped to [1, 100000]. Non-numeric, zero, and negative values fall back to the default.
Body encoding. Omit for the default body, an array of token objects. compact sends each source name once and each token as an array of values, which is about half the size and parses several times faster. It composes with limit. Any other value is refused with 400.
Example
address,name,symbol,decimals,sourcesOnly with format=compact: a comma-separated subset of address,name,symbol,decimals,logoURI,sources. address is required. Rows and the echoed fields always follow that canonical order, whatever order was requested. The top-level sources array is sent only when sources is selected. Omit for every field. Dropping logoURI roughly halves the raw size. Refused with 400 when used without format=compact, when a name is unknown or repeated, or when address is missing.
Admin only — rebuild this response instead of serving it from cache. Accepts 1 or true, and requires the admin bearer token; without a valid token the request is rejected with 401 rather than served from cache. Refresh responses are returned with cache-control: no-store so no content delivery network retains them.
Responses
Section titled “Responses”Ranked tokens with totals. With format=compact, the compact encoding instead.
object
Bare numeric chain id.
Prefixed identifier (eip155-369).
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
Compact encoding of TokensByChain (?format=compact). Decode row r as an object by pairing fields[i] with r[i], then replace each integer in the sources value with sources[index]. The fields array lists only the selected fields (see the fields query parameter). Every row shares the response chainId and chainIdentifier. An empty sources array means the default body has no sources property for that token.
object
Bare numeric chain id, shared by every row.
Prefixed identifier (eip155-369), shared by every row.
Name of each position in a token row: address (lowercase string), name (string), symbol (string), decimals (integer), logoURI (complete URL, as in the default body), sources (integer indexes into the sources array below).
Each distinct source (provider/list) once. Rows refer to entries by index. Absent when sources is not among the requested fields.
Example
{ "format": "compact", "fields": [ "address", "name", "symbol", "decimals", "logoURI", "sources" ]}Missing or syntactically invalid chainId — eip155 references must be numeric; chain 0 is asset-0. Also an unknown format value, or an invalid fields selection.
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"}