How to Add an Asset to Token List

How to Add Asset to Token List

What is This Guide For?

This guide shows a step by step procedure on how a token can be added to the Token List.
Learn more here: What is a Token List?

What Do I Need?

These are just suggested applications that you can use to easily navigate the assets repo

Fees for Submissions

Please be advised that there will be a small fee of TWT or BNB for every submission to the Trust Wallet repo. Please be advised that this is a non-refundable fee. Make sure that your token meets the criteria specified on this article.

Steps for Token Listing

  1. Using Github Desktop, clone the assets repo on your computer.

  2. Once it is completely synced, Open the repo by tapping on “Open in Visual Studio Code”

  3. For this guide, we will try to add HARD Protocol (HARD) that is on the Binance Smart Chain. Take note of the token contract address, and decimals.

  4. Using Visual Studio Code, navigate to the Token List file for the Binance Smart Chain folder:
    https://github.com/trustwallet/assets/blob/master/blockchains/smartchain/tokenlist.json

  5. Add another line for the new token under “pairs:”. The contract address will be used here. Follow the example on the screenshot.

  6. Next, add all the required token details, which will include the token name, symbol, contract address and decimals. You need to make sure to specify the path of the Logo as well. The token should already be on the Asset repo in order to display the images correctly.
    Follow the example on the screenshot.

Double check to make sure that everything is correct, then Save your changes.

  1. Go back to Github Desktop then create a New branch. The name should be related to the changes you are trying to submit.

  2. Create the pull request and provide as much details as you can to justify the submission.


  3. Submit the pull request and pay the fee once the bot asks for it.

  1. A maintainer will review and approve the submission. The pull request will be merged to the repository.

When Will The Token be Listed?

A maintainer will merge the pull request after further verification. This will be done as soon as possible. There will be notification emails sent to the one who submitted the pull request if there is anything needed or errors need to be corrected.
Once the pull request has been merged, the token list will be updated. The new token will be shown on DEX-Swap section of the app.

Disclaimer
Trust Wallet team allows anyone to submit new assets to this repository. However, this does not mean that we are in direct partnership with all of the projects.

Trust Wallet team will reject projects that are deemed as scam or fraudulent after careful review. Trust Wallet team reserves the right to change the terms of asset submissions at any time due to changing market conditions, risk of fraud, or any other factors we deem relevant.

4 Likes