Skip to main content

How to import Metamask data

A guide to adding your Metamask data and interpreting Etherscan data

Written by Scott

Important Note:
​If you want automatic tracking, have complex transactions, or engage in activities beyond simple asset holding (HODLing), we recommend using our automated integrations rather than importing your MetaMask transactions into a custom account.

These integrations update automatically, saving you time and effort compared to manually importing a CSV file. Right now we have support for Ethereum, Base, BNB Smart Chain, Polygon, Arbitrum One, Optimism, Gnosis, Linea and Hyperliquid (HyperEVM).

How to set up an automated wallet import

1. Ensure you have the correct Blockchain selected and copy your public wallet address - we use Ethereum in this example

2. Add a new wallet account and paste the address into Recap

3. That's it! We'll fetch your transactions and use them in your tax calculations

For blockchain wallets that we do not currently support

Downloading your data

1. Add a custom account for MetaMask in Recap

Head to Accounts, click Add Custom Account and type in a name for your wallet. You'll now see an empty card in the Accounts dashboard ready for your data to be added.

2. Find your MetaMask transactions

It isn't possible to find all the data you need from within the MetaMask wallet, so you'll need to find your transactions on a block explorer. The right explorer depends on the network selected in MetaMask; for Ethereum this is Etherscan, which we use in this example.

Head to the dropdown menu (the three dots) in the MetaMask extension and select "View on explorer". This opens the block explorer for the network you currently have selected (Etherscan for Ethereum).

The explorer shows the activity associated with your wallet address, but be aware that it can be split across several tabs: normal transactions, internal transactions, token transfers and NFT transfers. If a transaction you expect is not in the first list, check the other tabs (particularly Internal Transactions) before assuming it is missing. Click on individual transactions to access more information.

Adding your MetaMask data to Recap

When you have found your transactions in the explorer, there are two ways to add them into the Recap app:

  • Uploading a CSV

  • Add transactions individually

Method A - Uploading a CSV

  • Firstly, you need to create a CSV of all your data. Your CSV must be formatted correctly to be accepted by the Recap app; you can see and download our template below.

    The Recap CSV Template

(It is possible to download a CSV of your transactions from the explorer but this only provides an overview of transactions that you would need to add more detail to. You would also then need to reformat this to be accepted by our app, so we suggest that you start with the Recap CSV template and add your transactions into it.)

  • When your CSV is ready, head to Accounts in the Recap app and find the custom account card you created in Step 1

  • Click the Cog in the bottom right of the card and choose "Import CSV".

  • Locate your CSV and then click Import.

  • You'll return to the Accounts dashboard, where your CSV will be loading. As your data is imported it will populate the MetaMask card.

  • Click the MetaMask card to see your account chart and assets in more detail or head to activity to see your transactions in detail.

Method B - Add transactions individually

  • In the Recap app head to Activity and select Add Manual Transaction.

  • Choose the Transaction Type and then select the account you created in Step 1 from the Account dropdown. Now click Next.

  • Fill in the transaction details using the information in the explorer, then click Next.

  • You'll return to Activity, where you'll see the transaction has been added.

    Head to Accounts to see the transaction reflected in your MetaMask account card.

Still confused? Here's an example...

If you're struggling to interpret your transactions in the explorer, check out these illustrations (which use Etherscan) showing where to locate the information needed, and how it would appear in Recap by following Methods A and B above.


Transaction within Etherscan:

A. Transaction within a Recap formatted CSV:

B. Transaction added to Recap manually:

FAQs

What do I need to know about the gas price, gas fee and transaction fee?

On the Ethereum blockchain, validators process and confirm your activity. This takes computational power, so a transaction fee is paid to the network. The gas price is used to calculate this fee:

Transaction fee = Gas price x Gas used


​Often people refer to the transaction fee as the gas fee, as you are essentially paying for gas. Here's where the confusion starts for most users! In Etherscan, the gas price is listed directly below the transaction fee, so it is easily misinterpreted as an additional fee. When entering the transaction in Recap, use the Transaction Fee shown by the explorer. Do not enter Gas Price as a second fee; it is already used to calculate the Transaction Fee, as shown in the calculation above.

This all sounds like a lot of work! Do I need to import all of my activity? Even transactions that I know are not taxable?

Although not all trades are taxable, we would advise yes; the Recap app works most smoothly when it understands all of your activity, and this also ensures that your balances are correct and that your tax is accurate.

For example, if you choose not to include a deposit (as they are non-taxable) but later dispose of this asset, our tax calculator will not be able to find the original acquisition cost and so by default uses zero. This means that the gain on your disposal report will be incorrect (and unnecessarily high)!

Need more help?

Start a chat with us from the messenger in the bottom corner of this page and we'll be happy to help.

Please note:

Your data is your responsibility. We are not financial advisors and cannot advise on specific transactions or personal situations, but we are able to connect you with a tax professional if you need accounting advice.

Did this answer your question?