Use Your Wallet to Manage Ocean Tokens

How to use crypto wallet software to check your Ocean Token balance and to send Ocean Tokens to others.

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

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

Kovan or Nile Testnet

TestnetOcean Token Contract Address

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 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 (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 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

Ethereum Mainnet

The Ocean Token contract address in the Ethereum Mainnet is:


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.

MetaMask should now show your Ocean Token (OCEAN) balance, and when you’re looking at that, there should be a Send button to send Ocean Tokens to others. For help with that, see the MetaMask docs about how to send 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.