Skip to content

First requests

This page shows the URLs you will use most. Each one works in a browser, in curl and in an img tag.

https://gib.show/image/{chainId}/{address}

chainId is the number of the chain, for example 1 for Ethereum or 369 for PulseChain. address is the token contract address.

Terminal window
# Wrapped Bitcoin on Ethereum
curl https://gib.show/image/1/0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599
# A PulseChain token
curl https://gib.show/image/369/0xa1077a294dde1b09bb078844df40758a5d0f9a27

Gib answers with the image itself. If it has no image for the token, it answers with a 404 status.

Chains that are not Ethereum-style, such as Solana and Tron, need the prefixed chain identifier. See Chain identifiers.

Add w, h and as to get a smaller image in a lighter format:

Terminal window
curl "https://gib.show/image/1/0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599?w=72&h=72&as=webp"

Gib never makes an image larger than its source. Image options lists every option.

https://gib.show/image/{chainId}
Terminal window
curl https://gib.show/image/1

This is useful for chain selectors and network badges.

https://gib.show/list/{providerKey}/{listKey}?chainId={chainId}
Terminal window
# All lists the instance knows about
curl https://gib.show/list
# PulseChain tokens from Piteas
curl "https://gib.show/list/piteas/exchange?chainId=369"
# Ethereum tokens from Trust Wallet
curl https://gib.show/list/trustwallet/wallet-ethereum

The answer is a token list in the Uniswap token list format. Each token has a logoURI that points back at the same instance. See Token lists.

To read the best tokens of one chain from all providers at once, use /list/tokens/{chainId}.

Terminal window
curl "https://gib.show/list/search?q=usdc&chainId=eip155-369"

Search matches the name, the symbol and the address. Leave out chainId to search every chain. See Search.

<img
src="https://gib.show/image/1/0x2260FAC5E5542a773Aa44fBCfeDf7C193bc2C599?w=64&h=64&as=webp"
width="32"
height="32"
alt="WBTC"
/>

Ask for twice the size you show. That keeps the image sharp on high-density screens. More examples are in Integration examples.