Skip to content

Merged token list across providers for one chain, using a named ordering

GET
/list/merged/{order}
curl --request GET \
--url 'https://gib.show/list/merged/example?chainId=example'
order
required
string

Named ordering (e.g. default) or an explicit order id.

chainId
required
string

Chain to merge tokens for — prefixed form (eip155-369) or bare numeric (369). Required: the merged ordering query cannot complete across every chain at once.

decimals
string

Filter by token decimals. Repeatable (decimals=18&decimals=8).

Uniswap-style token list.

Media type: application/json
object
name
string
logoURI

List logo; null for merged lists.

string | null
timestamp
string format: date-time
version
object
major
integer
minor
integer
patch
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 generated

{
"name": "example",
"logoURI": "example",
"timestamp": "2026-04-15T12:00:00Z",
"version": {
"major": 1,
"minor": 1,
"patch": 1
},
"tokens": [
{
"chainId": 1,
"chainIdentifier": "example",
"address": "example",
"name": "example",
"symbol": "example",
"decimals": 1,
"logoURI": "example",
"sources": [
"example"
],
"extensions": {}
}
]
}

Missing chainId query parameter.

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}

Unknown provider, list, or order.

Media type: application/json
object
error
string

Example generated

{
"error": "example"
}