Vault Visibility
List and price a Morpho Vault V2 receipt token on CoinGecko, and add its logo, website and description to its Etherscan token page.
Wallets, explorers and other integrators show a vault receipt token using data from CoinGecko and Etherscan. Some integrators use the CoinGecko API to display vault receipt tokens and their price: if a vault is not priced on CoinGecko, they can show users' vault positions at a value of 0. On Etherscan, the vault's token page only shows onchain data until its logo, website and description are added.
This guide covers two separate requests, both require you to be logged in to your CoinGecko or Etherscan account:
| Platform | What the request adds | Form |
|---|---|---|
| CoinGecko | The vault receipt token and its price, used by integrators that read the CoinGecko API | CoinGecko request form |
| Etherscan | Offchain information on the vault's token page: logo, website, description and social profiles | Etherscan token update form |
Price the Vault Token on CoinGecko
The sample texts below use these placeholders. Replace each one with your vault's details:
| Placeholder | Value |
|---|---|
VAULT_NAME | The vault's name, returned by name() on the vault contract |
VAULT_SYMBOL | The vault's symbol, returned by symbol() on the vault contract |
VAULT_ADDRESS | The vault address |
CHAIN | The vault's chain (Ethereum, Base, etc.) |
CURATOR_NAME | Your name as the vault's curator |
UNDERLYING_ASSET | The vault's underlying asset, for example USDC |
UNDERLYING_DECIMALS | The decimals of the underlying asset, for example 6 for USDC |
ONE_TOKEN | 10 to the power of the vault's decimals: 1000000000000000000 for a vault with 18 decimals |
YOUR_CONTACT | Your own contact for CoinGecko's questions |
1. Open a new listing request
Open the CoinGecko request form, log in, choose New Coin/Token Listing, then set Choose Your Listing Type to Active Listing. Preview Listing is for tokens that haven't launched yet.
The form has 16 numbered sections over three pages: Basic Coin Information (sections 1 to 5), Supply Information (6 to 11) and Additional Information (12 to 16). Fields marked with a red asterisk are required.
2. Fill in the Basic Coin Information page
| Section | Field | Value |
|---|---|---|
| 1. Basic Coin/Token Information | Coin/Token Name | VAULT_NAME |
Coin/Token Symbol | VAULT_SYMBOL | |
Website URL | Your own website, not the vault link on the Morpho app | |
Website URL (2), Website URL (3), Whitepaper Link | Optional | |
Submitter's Role | Optional. Your role, for example Curator | |
Submitter's Telegram Username | Optional. CoinGecko can use it to contact you about the request | |
| 2. Project Information | What is the project about? | The sample description below. CoinGecko requires at least 400 characters, written in the third person, factual and without bold claims |
What makes your project unique?, History of your project?, What's next for your project?, What can your coin/token be used for? | Optional. Each answer needs at least 400 characters | |
| 3. Exchange Trading Information | Exchange Name and Exchange Trade URL | A trading pair of the vault receipt token on an exchange listed on CoinGecko. For a pool on an AMM such as Uniswap, use the analytics page of the pair. If there is no trading pair, select an exchange and explain it in Remarks (section 16) |
| 4. Block Explorer Links | Explorer Link | https://etherscan.io/token/VAULT_ADDRESS, using the explorer of the vault's chain |
Explorer Link (2) to Explorer Link (5) | Optional | |
| 5. Asset Type & Details | Coin or Token | Token |
Blockchain Platform (1) | CHAIN | |
Contract Address (1) | VAULT_ADDRESS | |
Contract Decimal Places (1) | The vault's decimals, returned by decimals() on the vault contract (18 when the underlying asset has 18 decimals or fewer) |
Sample description for What is the project about?:
VAULT_SYMBOL is the vault receipt token of VAULT_NAME, a vault deployed with the Morpho Vault V2 smart contracts on CHAIN at VAULT_ADDRESS and curated by CURATOR_NAME. When users deposit UNDERLYING_ASSET into the vault, they receive vault receipt tokens (ERC-20). When they withdraw, these tokens are burned and the users get UNDERLYING_ASSET back. The vault allocates deposits to Morpho Markets within the risk parameters set by its curator. The amount of UNDERLYING_ASSET that one vault receipt token can be redeemed for is variable: it changes as interest paid by borrowers accrues to the vault.Click Next: Supply Information.
3. Fill in the Supply Information page
| Section | Field | Value |
|---|---|---|
| 6. Coin Holders & Distribution Schedule | Top Holder List Url | https://etherscan.io/token/VAULT_ADDRESS, using the explorer of the vault's chain. The token page lists the top holders |
Distribution Schedule | NA | |
| 7. Coin/Token Supply Information | Token Generation Date (TGE) | The vault creation date |
Max Supply Amount | Tick Is Infinite Supply | |
| 8. Total Supply | Total Supply Amount | The total supply shown on the vault's token page on the explorer when you fill in the form |
Total Supply API, Burned Wallet | Leave empty | |
| 9. Circulating Supply | Circulating Supply Amount | The same amount as Total Supply Amount |
Circulating Supply API, Vested/Locked Wallet | Leave empty | |
| 10. Initial Token Allocation | Leave empty: don't click Add New Allocation | |
| 11. Additional Supply Information | Text field | The sample text below |
Sample text for Additional Supply Information:
The supply of VAULT_SYMBOL is not fixed. Vault receipt tokens are minted when users deposit UNDERLYING_ASSET into the vault and burned when they withdraw, so the total supply follows the deposits and withdrawals of the vault.Click Next: Additional Information.
4. Fill in the Additional Information page
| Section | Field | Value |
|---|---|---|
| 12. Community Information | Social links | Optional. Your own profiles, for example your X profile |
| 13. Coin/Token Category | Category 1 | Morpho Ecosystem (morpho-ecosystem) |
Reason 1 | The sample reason below. CoinGecko requires at least 250 characters | |
Category 2, Category 3 | Optional | |
| 14. Developer Information | GitHub | Optional. For example the Vault V2 source code: https://github.com/morpho-org/vault-v2 |
| 15. Attachments | Token Image | The vault logo: PNG, JPG or WEBP, 200x200 px, preferably with a transparent background |
Project Banner Image | A banner for the vault: PNG or JPG, at least 1360x430 px, 2 MB at most | |
| 16. Additional Information | Remarks | The pricing remark below |
Sample reason for Reason 1:
VAULT_SYMBOL is the vault receipt token of a vault deployed with the Morpho Vault V2 smart contracts. Users receive it when they deposit UNDERLYING_ASSET into the vault, and it is burned when they withdraw. Other Morpho vault receipt tokens are already listed in this category: https://www.coingecko.com/en/categories/morpho-ecosystemPricing remark for Remarks:
Pricing of VAULT_SYMBOL
Chain: CHAIN
Vault address: VAULT_ADDRESS
VAULT_SYMBOL is a vault receipt token and is not meant for trading, so it may have no trading pair. Its price comes from the vault contract:
1. Call convertToAssets(ONE_TOKEN) on VAULT_ADDRESS, where ONE_TOKEN = 10^vault decimals (1000000000000000000 for a vault with 18 decimals). As a raw eth_call on any CHAIN RPC: to = VAULT_ADDRESS, data = 0x07a2d13a followed by ONE_TOKEN as a 32-byte hex value. For 18 decimals: 0x07a2d13a0000000000000000000000000000000000000000000000000de0b6b3a7640000
2. Divide the result by 10^UNDERLYING_DECIMALS. This gives the amount of UNDERLYING_ASSET for one VAULT_SYMBOL.
3. Multiply that amount by the CoinGecko price of UNDERLYING_ASSET to get the price of VAULT_SYMBOL.
For verification, please contact YOUR_CONTACT.Before you paste the remark, set ONE_TOKEN to 10 to the power of your vault's decimals, returned by decimals() on the vault contract. Most vaults have 18 decimals, so the 18-decimal call data in the remark works as is; a vault whose underlying asset has more than 18 decimals uses the asset's decimals.
5. Choose the review speed and submit
Under Upgrade to a Faster Review, keep Regular Pass (free, response within 5 days) or pick the paid Fast Pass (response within 24 hours).
Tick the required boxes: Listing Terms, Support Terms, Accuracy Declaration, Information Usage Note and Public Verification Post. Offers and Promotions is optional. Complete the captcha and submit the request. If you aren't logged in, the button reads Login to Submit.
CoinGecko sends an email when it receives the request and another one when it approves it.
Update the Vault Token Information on Etherscan
By default, a token page on Etherscan only shows onchain data. A token information update adds offchain information such as the logo, website, description and social profiles. The same process applies to the other explorers built by Etherscan (Basescan, Arbiscan, etc.) where the feature is available.
Etherscan reviews every request before publishing it. The update is free, and Etherscan offers a paid Priority Support plan for faster processing.
1. Verify ownership of the vault address
Log in to your Etherscan account, open Verified Addresses from the account menu, click Add Address, enter the vault address and sign the message with the wallet that deployed the vault (the address that sent the vault creation transaction). Etherscan lists the addresses it accepts for the signature on that page.
See Etherscan's guide: How to Verify Contract Address Ownership.
2. Submit the token update request
Fill in the token update form and pick the request type:
| Request type | When to use it |
|---|---|
| New/First Time Token Update | The token page has never been updated |
| Existing Token Info Update | The token page was updated before and some information needs to change |
Etherscan's main requirements for the submission (full guidelines):
| Item | Requirement |
|---|---|
| Website | Accessible, with working links and clear information about the project |
| Email address | On the project's official domain, or the official email address shown on the website |
| Logo | SVG at 32x32 or PNG at 64x64, with a public download link |
| Description | Neutral, without exaggerated or comparative claims |
| Social profiles | Full links, not usernames |