Teach Your Wallet to Track Ocean Tokens

How to teach various crypto wallet software to track Ocean Tokens.

If you don’t see any Ocean Tokens in your wallet software (e.g. MetaMask or MyEtherWallet), don’t worry! It might not know how to track Ocean Tokens yet. You can teach it how.

Step 1: Determine the Ocean Token Contract Address in the Network You’re Using

Kovan or Nile Testnet

TestnetOcean Token Contract Address
Kovan0xB57C4D626548eB8AC0B82b086721516493E2908d
Nile0x9861Da395d7da984D5E8C712c2EDE44b41F777Ad

If the above addresses are out-of-date, then you can find newer ones in the keeper-contracts repository on GitHub:

  1. Click on the “Branch: develop” button and switch to the tag of the latest release (e.g. v0.8.6).

  2. In the README.md file, check the address of the OceanToken contract (in Nile or Kovan).

  3. Double-check the address by looking in the file named zos.kovan.json (for Kovan) or zos.dev-8995.json (for Nile). Search for /OceanToken. There should be one result and the text around it should look like:

    "@oceanprotocol/keeper-contracts/OceanToken": [
      {
        "address": "0x9861Da395d7da984D5E8C712c2EDE44b41F777Ad",

    Compare the "address" value to the value from the README.md file.

Spree or Ganache-Based Testnet

If you’re using Barge to run a local Spree Testnet or a local Ganache-based testnet, then you can get the address of the OceanToken contract by looking at the value of "address" in:

  • $HOME/.ocean/keeper-contracts/artifacts/OceanToken.spree.json for Spree
  • $HOME/.ocean/keeper-contracts/artifacts/OceanToken.development.json for Ganache

Step 2: Teach Your Wallet Software about Ocean Tokens

MetaMask Instructions

  1. Make sure MetaMask is connected to the correct network (Nile, Kovan or whatever). See the tutorial about how to do that.
  2. For the account you want to manage, click the (hamburger menu icon).
  3. Scroll down until the ADD TOKEN link is visible, then click on it.
  4. Click on Custom Token.
  5. Paste the OceanToken contract address (from Step 1 above) into the “Token Contract Address” field. The other two fields should auto-fill. If they don’t then something is wrong.
  6. Click NEXT.
  7. Click ADD TOKENS.

Other Wallet Software

Do a web search to find out how to add a custom ERC-20 token to the wallet software you’re using.