MetaMask Logo

How to Connect MetaMask and Koinly

Simplify MetaMask tax reporting with Koinly. Integrate via API or CSV to easily calculate the tax liability of your MetaMask transactions, trading and history. Get started for FREE!

API Import
Last updated: Monday, 29 August 2022

How to connect MetaMask with Koinly

MetaMask is a popular in-browser wallet for crypto investors looking to buy, store, send and swap on the Ethereum blockchain. It's also an option for those interested in investing in DeFi and exploring DApps and has attracted more than 5 million users.

How to get a tax statement from MetaMask?

You might be wondering, does MetaMask provide CSV tax and trade history reports? Is it even possible to get tax info and statements from MetaMask? What about a MetaMask tax API? The good news is, while MetaMask might not provide tax forms and documents, MetaMask does offer one easy way to export transaction and trade history!

MetaMask pairs with Koinly through API file import to make reporting your crypto taxes easy. Once connected, Koinly becomes the ultimate MetaMask tax tool. How? Koinly will calculate your MetaMask taxes based on your location AND generate your EOFY tax report, all within 20 minutes! All you’ll need to do at tax time is download your MetaMask tax statement from Koinly and file it with your local tax authority. Done!

Connect to Koinly with the MetaMask tax report API

The best way to integrate MetaMask with your Koinly account is using the MetaMask browser extension. This is available on Chrome, FireFox and Brave. You can install the MetaMask browser extension on any of these browsers and we highly recommend doing this before you follow our API steps below.

On Koinly

  1. Sign up or log in to your Koinly account and go to the wallets page.
  2. Select add new wallet: MetaMask.
  3. Select set up auto-sync.

In Browser:

  1. Select the MetaMask extension icon in the top right corner of your browser.
  2. From the drop down tab at the top, find the Ethereum Mainnet option.
  3. Under the account name, copy the public address.

MetaMask instructions Koinly

Back to Koinly:

  1. Paste the public address into the public address or key box.
  2. Select secure import.

Syncing other networks

Syncing your MetaMask wallet will sync all of your Ethereum transactions. To connect to other networks like Binance Smart Chain or Polygon, you'll need to create separate wallets for these networks in Koinly. You can do this by logging into your Koinly account and going to wallets. Instead of connecting MetaMask, find the network you want to connect, for example Polygon or Binance Smart Chain. Then find the public address for these networks in your MetaMask browser extension and copy and paste these into Koinly to import.

Good to know
Auto-syncing your MetaMask data takes a couple of minutes on Koinly. This is normal, Koinly is just working through your transactions to identify which are taxable events and which aren't. Once your data is imported, you might notice a small yellow warning icon next to your MetaMask wallet. This icon indicates an issue with imported data, click on it to find out the precise issue. You can learn more about how to resolve this in this guide. MetaMask doesn't give the option to export CSV files, although you can use some third-party providers to export CSV data directly from the ETH blockchain.

How do I troubleshoot my MetaMask integration to Koinly?

Something not working with your MetaMask data import? There’s plenty of help available: