Token Registration on Bitsy Wiki

Making the Icon

Mon, 01 Jan 0001 00:00:00 +0000

A token icon is displayed at 20 to 24 pixels in a wallet balance row, which is the size at which it does its actual work. Everything else — the 256-pixel version in the repository, the 512-pixel version on the project page — is a downscale target. Design for the 20-pixel render, then produce the eight files the registrars ask for from one vector source.

Constraints that come from the render size#

One mark, no wordmark. The symbol is already printed next to the icon in every interface that shows it. Lettering inside a 20-pixel square is four or five pixels tall and resolves to a smear.
Stroke weight at or above 6% of the canvas. A 256-pixel canvas wants strokes of 16 pixels or more, which land at about 1.25 pixels in a 20-pixel row; below about 13 pixels the downscale drops them under one pixel and the antialiaser turns them into grey haze.
Two colors, high contrast. Gradients average out at small sizes, so a gradient icon renders as its mean color and stops being distinguishable from every other icon whose mean is a similar blue.
Give the mark its own disc. Surfaces disagree about their background: Etherscan is light, most wallets default to dark, and a transparent icon that is pure black or pure white vanishes on one of them. A filled circle behind the mark makes the icon background-independent and also survives the circular cropping several wallets apply.
Keep the mark inside 80% of the canvas. Interfaces that crop to a circle cut the corners off a square icon, and MetaMask’s icon style guide asks for artwork “within 80% of the canvas”. The background disc is not artwork in that sense; the mark on it is.

The source file#

Author in SVG and rasterize from it. A hand-drawn 256-pixel bitmap cannot produce a clean 32-pixel version, but the reverse works every time.

On-Chain Metadata

Mon, 01 Jan 0001 00:00:00 +0000

Two mechanisms let a token carry its own icon without a company’s approval: a metadata document referenced from the contract, and a wallet method your interface can call to push the icon at the user directly. Neither needs a form, a fee, or a queue, and both work in the same block the contract is deployed in.

ERC-1046: a `tokenURI` on a fungible token#

ERC-1046 is Final, and adds one function to ERC-20:

Token Lists

Mon, 01 Jan 0001 00:00:00 +0000

A token list is a JSON document that maps chain identifier and contract address to a name, symbol, decimals count and logo URL. It is the only registration route where you are the publisher rather than the applicant: you write the file, you host it, and a user adds it to their interface by pasting a URL. Uniswap wrote the specification in 2020 and most swap interfaces and several wallets read the format.

Block Explorers

Mon, 01 Jan 0001 00:00:00 +0000

A block explorer’s token page is the first result when anyone searches a contract address, and its logo, description and links come from the explorer’s own database, not the chain. Two explorer families cover most EVM chains — Ethereum Virtual Machine chains — and each has its own page here:

	Etherscan family	Blockscout
Covers	Etherscan, Basescan, Arbiscan, Polygonscan, BscScan, OP Mainnet’s Etherscan, and the rest of the thirty-odd explorers Etherscan lists	Blockscout-hosted instances, including Ethereum, Base, Arbitrum One, OP Mainnet and Polygon
Channel	Token Update Application Form, one per explorer	token info application form, one per instance
Prerequisites	verified source, then a signed ownership proof	verified source, then a signed ownership proof
Who may sign	the creator Etherscan displays; its one readable article on factory deployments sends them to support	creator or `owner()`; the web front end also offers the sender of a factory deployment, backend unconfirmed
Logo	a link to a 32 × 32 SVG or 64 × 64 PNG	a link to an SVG or a 48 × 48 PNG
Cost	free; paid priority support, price shown after submitting	free; 99 USDC or USDT for a decision within seven days
Reads aggregators	CoinMarketCap, for market data	CoinGecko for logos and project data; both for market data

Both are free to use, both need the contract’s source code verified first, and both key everything by chain, so a token on six chains is six Etherscan-family submissions and, since Blockscout hosts no BNB Smart Chain explorer, up to five Blockscout ones — fewer where a CoinGecko listing already supplies the data. Neither documents token information carrying over from an implementation contract to the clones created from it.

Data Aggregators

Mon, 01 Jan 0001 00:00:00 +0000

Market-data sites come in two kinds, and registering with each kind means something different. Aggregators — CoinGecko and CoinMarketCap — hold one reviewed record per asset, with every chain’s contract address in it, and a token team applies for that record. Pool trackers — GeckoTerminal, Dexscreener and DEXTools — index trading pairs on decentralized exchanges automatically, one page per chain, and what a token team buys is the profile attached to a page. DefiLlama is a third case: it lists protocols by the value they hold, not tokens.

Wallet Registries

Mon, 01 Jan 0001 00:00:00 +0000

Before token lists existed, wallets shipped their icons as a directory of files in a public repository, and adding a token meant opening a pull request against it. Three of those repositories still take submissions, and each now has its own page. They differ less in format than in who they let in:

Registry	Channel	Cost	Bar to entry	Pace
Trust Wallet	pull request to `trustwallet/assets`	500 TWT or 2.5 BNB per pull request	CoinMarketCap listing, audit, 10,000 holders and 15,000 transactions	human review after the fee is paid
MetaMask	pull request to `MetaMask/contract-metadata`	none	signs of activity, a website citing the address	310 pull requests open; one outside submission took eight weeks
ethereum-lists	pull request to `ethereum-lists/tokens`	none	a valid file; sixteen chains only	months between merges

All three key a token by its checksummed address inside a per-chain folder, so a token deployed at the same address on six chains is six sets of files, whichever registry takes it.

Registering on Uniswap

Mon, 01 Jan 0001 00:00:00 +0000

There is no Uniswap form for a token image. The logo beside a token on app.uniswap.org, the interface to the Uniswap protocol, is a string called project.logoUrl. Uniswap’s own backend hands it to the interface when the page loads, and it is copied from CoinGecko. Uniswap Labs states the rule in as many words: “Uniswap Labs sources token information and token logos from CoinGecko.” Change the logo on CoinGecko, wait about 48 hours, and it changes on Uniswap.

Registering on Etherscan

Mon, 01 Jan 0001 00:00:00 +0000

Etherscan’s token page — the first search result for a contract address — shows a logo, description and project links only after someone who has proved control of the contract submits them through Etherscan’s Token Update Application Form. The update is free and needs no liquidity or holder count. It has three prerequisites, in order: an Etherscan account, source code verified on the explorer, and a signed message proving ownership of the contract address. Each explorer in the Etherscan family — Basescan, Arbiscan, BscScan and the rest — takes its own submission.

Registering on Blockscout

Mon, 01 Jan 0001 00:00:00 +0000

Blockscout is an open-source block explorer, and the company behind it hosts it for many chains, each as a separate instance with its own address such as eth.blockscout.com. A token’s project information on a Blockscout explorer — logo, description, website, links — comes from one of two places: a CoinGecko listing, which Blockscout reads automatically — it queries CoinMarketCap too, but for market data — or a token info application submitted to that instance by the token’s owner. The application requires a verified contract and a signed ownership proof, takes the logo as a link rather than an upload, and is reviewed either with no guaranteed timeline or, for 99 USDC or USDT, within seven days.

Registering on GeckoTerminal

Mon, 01 Jan 0001 00:00:00 +0000

GeckoTerminal is CoinGecko’s tracker for decentralized exchange pools. It indexes pools on the exchanges it supports automatically and for free, so a token appears there — with a price chart and a trade history — once its first pool is on a supported exchange, and nobody has to apply. What a token team can submit is the token info attached to that token on one chain: logo, banner, description, website, social links and categories. As of September 2026 that submission costs $199 and is reviewed within 24 hours.

Registering on Dexscreener

Mon, 01 Jan 0001 00:00:00 +0000

Dexscreener is a chart and pair tracker for decentralized exchanges (DEXs). It lists every pool on the exchanges it supports without an application — “as soon as they are added to a liquidity pool and have at least one transaction” — so a token’s price chart appears with no involvement from its team. What a team can buy is the token’s profile: the icon, header image, description, website and social links shown beside the chart. The product is called Enhanced Token Info, it costs $299, and it is processed within minutes to twelve hours. It is one of the few routes that puts a logo beside a token in its first week.

Registering on DEXTools

Mon, 01 Jan 0001 00:00:00 +0000

DEXTools is a trading dashboard for decentralized exchange (DEX) pairs. It does not list tokens in any sense a team applies for — “DEXTools does not ’list’ tokens! but instead pulls data directly from the blockchain in real time” — so a pair appears as soon as the token trades on a supported exchange. The token’s profile beside the pair — logo, banner, a 140-character description, categories and social links — comes either from CoinGecko, for tokens listed there, or from a paid marketplace order called Token Info & Social Updates, displayed at $195.

Registering on CoinGecko

Mon, 01 Jan 0001 00:00:00 +0000

A CoinGecko listing is a coin page: one record per asset, carrying a name, symbol, logo, description, links, supply figures, and a map from each blockchain the asset lives on to its contract address there. The record is created when a request form on CoinGecko’s partner platform passes a staff review. Review is free and takes up to five days, or 24 hours for $1,000. There is one hard prerequisite: the token must already be trading on an exchange CoinGecko tracks.

Registering on CoinMarketCap

Mon, 01 Jan 0001 00:00:00 +0000

CoinMarketCap (CMC) says “the majority of assets are now listed automatically”: its DexScan service creates a page for each trading pair on a decentralized exchange (DEX) from on-chain data, without a name check, a logo or a review. What a token team applies for is a verified listing — one reviewed coin page with a project name, logo, links, supply figures and every chain’s contract address, identified by a Unified Cryptoasset ID (UCID). The application is a request form on CoinMarketCap’s support site. The free route has, in CoinMarketCap’s words, outcomes that “can range from days to months/years”; the paid one, CMC Priority (CMCP), costs USD 5,000 per page with a turnaround of about a business day.

Registering on DefiLlama

Mon, 01 Jan 0001 00:00:00 +0000

DefiLlama lists protocols, not tokens. A listing is a page showing a protocol’s total value locked (TVL) — the value of the assets its contracts hold — and it is created by a pull request to the DefiLlama/DefiLlama-Adapters repository adding an adapter: a small JavaScript module that computes that value from on-chain data. The protocol’s name, logo, links and token are not files in the pull request. They are answers to a questionnaire in the pull request’s description, which DefiLlama’s staff turn into the listing themselves. No fee appears anywhere in the documented process.

Registering on MetaMask

Mon, 01 Jan 0001 00:00:00 +0000

MetaMask has no listing form. The name and icon it shows for a token come from its Token API, a MetaMask service that merges token lists from a dozen or more third parties — swap routers, bridges, CoinGecko, CoinMarketCap, Trust Wallet — and counts, for each token on each chain, how many of those lists carry it. A token on enough of them is detected automatically in a user’s wallet; the default threshold in MetaMask’s current code is three. Getting a token in front of MetaMask users therefore means one of three things: be on enough upstream lists, get an entry into MetaMask’s own contract-metadata repository, which counts as one of those lists, or have your own interface call wallet_watchAsset, which needs nobody’s approval.

Registering on Trust Wallet

Mon, 01 Jan 0001 00:00:00 +0000

Trust Wallet takes a token’s logo and description from trustwallet/assets, a public GitHub repository with one folder per token per chain. Each folder holds exactly two files, logo.png and info.json, and getting a token in means a pull request that adds them, a fee of 500 TWT — Trust Wallet’s own token — or 2.5 BNB per pull request, and a review against criteria that include 10,000 holders. The repository’s README states the consequence directly: “brand new tokens are not accepted”. For a token launched this month, this page is a description of a milestone rather than a step.

Registering on ethereum-lists

Mon, 01 Jan 0001 00:00:00 +0000

ethereum-lists/tokens is a community-maintained GitHub repository holding one JSON file per token per chain, named after the token’s address. A build step assembles the files into combined lists, and hardware-wallet firmware and a few older wallets import the result. Adding a token is a pull request with one file: no fee, no holder count, no audit. The cost is pace and coverage. The last token pull request merged on 4 April 2026, and the repository knows sixteen chains, which include Ethereum, Arbitrum and BNB Smart Chain but not Base, OP Mainnet or Polygon.

Token Registration on Bitsy Wiki

Making the Icon

Constraints that come from the render size#

The source file#

On-Chain Metadata

ERC-1046: a tokenURI on a fungible token#

Token Lists

Block Explorers

Data Aggregators

Wallet Registries

Registering on Uniswap

Registering on Etherscan

Registering on Blockscout

Registering on GeckoTerminal

Registering on Dexscreener

Registering on DEXTools

Registering on CoinGecko

Registering on CoinMarketCap

Registering on DefiLlama

Registering on MetaMask

Registering on Trust Wallet

Registering on ethereum-lists

ERC-1046: a `tokenURI` on a fungible token#