Token Display
Fungibles
Display fungible tokens
Phantom prioritizes on-chain metadata that follows the Token Metadata Standard. For fungible tokens specifically, Phantom will show the following fields:| Field | Description |
|---|---|
| name | The name of the token, such as “USD Coin.” |
| symbol | The symbol of the token, such as ”USDC.” |
| image | A URI pointing to the token’s logo. |
Fungible token has name and symbol fields present on both its on-chain Metadata Account and off-chain JSON file (linked via the on-chain uri field), Phantom will prioritize the on-chain fields.
If a Fungible token does not have an on-chain Metadata Account, Phantom will fallback to displaying data from the Solana Labs Token List. This list is considered deprecated and should not be used to host new tokens. When reading from the token list, Phantom will display the following fields:
| Field | Description |
|---|---|
| name | The name of the token, such as “USD Coin.” |
| symbol | The symbol of the token, such as ”USDC.” |
| logoURI | A URI pointing to the token’s logo. |
| extensions.coingeckoID | The token ID as defined by the Coingecko API. Phantom uses this to fetch the price of the token. |
Display prices
Phantom will display prices for any token that is verified on Coingecko. When verifying with Coingecko, be sure to include the token’scontract. For Solana tokens, this should be the mint address. For example, Bonk is verified with the contract DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263. Once a token has verified its contract address with Coingecko, Phantom will automatically begin displaying its price.
If Coingecko is unable to return a price for a given token, Phantom will fallback to using Birdeye for token prices.