Koinly Logo

How to Connect with Koinly

How to connect with Koinly is a non-custodial PoS platform, letting you use your favorite DeFi protocols all from one spot. It supports many popular PoS blockchains, including ETH, ATOM, XTZ and more. Whatever your investments are, Koinly can help you with your taxes. Koinly connects to via API or by uploading a CSV file of your transaction history. Here's how it works.

Watch how to do your taxes fast

How to connect to Koinly via API

You'll need to get your wallet address for each blockchain you interact with through - for example Cosmos, Tezos and Ethereum. The instructions will be similar for each.


  1. Log in to
  2. In the left hand menu, select the blockchain you'd like to connect to Koinly. For example, ATOM or OSMO.
  3. Once you're on the relevant page, select the copy icon next to your public address.
  4. Head over to Koinly.

On Koinly

  1. Log in to Koinly and go to the wallets page.
  2. Select add new wallet: Citadel One.
  3. Select set up auto sync.
  4. Search for the blockchain you're connecting - for example, Cosmos or Osmosis.
  5. Select the relevant blockchain.
  6. Paste the address you copied from
  7. Select import.

Good to know
You'll need to repeat the steps above for every blockchain you interact with via and add all these to Koinly.

How to connect to Koinly via CSV

There's no way to export a CSV file directly from But you can create a custom CSV file with your transaction data and upload this to Koinly instead.

On Koinly

  1. Sign up or login into Koinly and head to the wallets page.
  2. Add a new wallet: Citadel One.
  3. Select import from file.
  4. Upload your CSV file(s).

Good to know
It's a good idea to double check your staking rewards are tagged correctly in Koinly for your country’s tax rules.

How do I check if my import is accurate?

Not sure everything is right with your data import? Don't panic - there's lots of resources available:

It's really helpful to use our Getting Started Guide before reviewing your transactions. This can help you identify and resolve any issues in no time at all.