Add a Custom ERC-20

Add a custom ERC-20 support to Reservoir

πŸ“˜

Please Check Coingecko

If your custom ERC-20 is available and traded on CoinGecko, you do not need to complete the steps here. Please reference the How to list in different ERC-20's guide to get started with alternative currency.

Reservoir enables users to create and fill orders in any ERC-20 token. If your token has liquidity and is available on CoinGecko it will be supported out of the box.

If your token does not have liquidity and is not available on CoinGecko, it will require special handling in our indexer outlined below.

Please note that if your ERC-20 does not have liquidity on CoinGecko, the conversion from your token to USD might not be accurate. This conversion happens because we have to assign a USD to ERC-20 rate since this isn't available from CoinGecko.

How to add custom ERC-20 support to Reservoir

To add support for your custom ERC-20 Token follow these steps below:

  1. Add your custom token details here
[
            "0xceb726e6383468dd8ac0b513c8330cc9fb4024a8", // MUST BE LOWERCASE
            {
              contract: "0xceb726e6383468dd8ac0b513c8330cc9fb4024a8",
              name: "Worms",
              symbol: "WORMS",
              decimals: 18,
              metadata: { // OPTIONAL
                image:
                  "{ICON_URL}", 
              },
            },
          ]
  1. Submit a PR and add the reservoirprotocol/backend team as a reviewer.
  2. Once our team has reviewed and merged the PR, the token will be supported.