Skip to content

All deduplicated tokens for a chain, ranked by list priority

GET
/list/tokens/{chainId}
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.

chainId
required
string

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.

limit
integer
default: 50000 >= 1 <= 100000

Maximum tokens returned, clamped to [1, 100000]. Non-numeric, zero, and negative values fall back to the default.

format
string
Allowed values: compact

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.

fields
string

Example

address,name,symbol,decimals,sources

Only 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.

refresh
string

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.

Ranked tokens with totals. With format=compact, the compact encoding instead.

Media type: application/json
One of:
object
chainId

Bare numeric chain id.

integer
chainIdentifier

Prefixed identifier (eip155-369).

string
total
integer
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

{
"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.

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"
}