In most cases you should not need to create a custom file as Koinly can handle almost every csv and excel file out there. However, if your exchange or wallet does not have export functionality then you can follow these instructions to create your own.

 
 

Instructions

  1. Select one of the templates below and click on the link to go to the Google Sheets page for it.
  2. Click on File > Make a Copy in the top right corner (you will need a google account for this - if you don't have one then click on File > Download > CSV to download the file and edit it using Excel or another tool)
  3. Remove the sample data rows once you understand how to enter your own data.
  4. When you have finished entering the data click on File > Download > Comma-separated values (CSV) to download the file and import it into Koinly.

 
 

1. For importing deposits/withdrawals/mining

This format is ideal for importing deposits and withdrawals from wallets/blockchains/mining pools etc. Basically anywhere you have incoming and outgoing transactions. 

If you also need to import trades then you can use the second file format that we have created specifically for trades. You can also look at the Universal file format which will allow you to import all deposits/withdrawals/trades using a single file.

Sample data explained:

  • The first sample row in this file contains an incoming transaction of 20 BTC which is tagged as mining income.
  • The second row contains an outgoing/send transaction of 20 BTC.

Required fields:

  • Koinly Date, Amount, Currency

Optional fields:

  • Net Worth Amount, Net Worth Currency, Label, Description, TxHash

 
 
 

2. For importing Trades

This file is ideal for importing trades that are displayed using their market pair/side, instead of the amount you sent/received. 

If your exchange shows you the amount you have sent and the amount you have received separately then you should look at the universal import format instead.

Sample data explained:

  • The first sample row in this file contains a trade of 1000 USD to 1 BTC with a fee of 5 USD on top. In other words: you are buying 1 BTC for 1000 USD + fee.
  • The second row contains a sale of 1 BTC for 900 USD with a fee of 3 USD on top. In other words, you sold 1 BTC for 900 USD + fee.

Required fields:

  • Koinly Date, Pair, Side, Amount, Total

Optional fields:

  • Fee Amount, Fee Currency, Order ID, Trade ID

 
 

3. Universal format

This format can be used for importing any kind of data. You have to specify the amount you are sending and the amount you are receiving on separate fields. This means you can use the file for deposits/withdrawals and even trades.

Sample data explained:

  • The first sample row in this file contains a trade of 1000 USD to 1 BTC with a fee of 5 USD on top. In other words you are buying 1 BTC for 1000 USD + fee.
  • The second row contains an outgoing/send transaction of 0.5 BTC.
  • The third row contains an incoming transaction of 1 BTC from mining. 

Required fields:

  • Date, Sent Amount, Sent Currency, Received Amount, Received Currency

Optional fields:

  • Fee Amount, Fee Currency, Net Worth Amount, Net Worth Currency, Label, Description, TxHash


 
 
 

Fields explained:

Decimal separators

Always use the dot separator, we do not support comma separators. Ex: 0.55 BTC is good and 0,55 BTC is bad.

 

Date

All date fields must be formatted like this: YYYY-MM-DD HH:mm:ss. For ex. if you want to enter 5th Jan 2019 the date will be 2019-01-05. All dates should be in UTC.

 

TxHash

Duplicate transactions will be ignored if a TxHash is provided. In cases where no txhash is provided Koinly will attempt to ignore duplicates by generating a unique txhash based on the row contents and index of the row.

 

Order ID / Trade ID

Entering an order ID will ensure that Koinly doesn't accidentally reimport the same row. It works in the same way as the TxHash. Providing a Trade ID will allow Koinly to group trades for the same Order (Avalanche Trades).

 

Net worth amount & Currency

You can set these if you know what the market rate of the transaction was at the time of the transaction. If it is empty Koinly will determine the market rate automatically. Read more about market prices on Koinly here

The Net worth amount/currency are ignored if you bought or sold some coins using a fiat currency, in such cases Koinly will use the fiat as the market value instead.

The Net worth currency must be a fiat currency like USD, EUR, GBP etc. The net worth amount should NOT include the value of the fee. If you have paid fees in a different cryptocurrency and want to specify the exact worth of the fee as well, you can use the Fee Worth and Fee Worth Currency columns instead.

 

Fee amount & Currency

These are the fees you paid when trading and can be in any fiat or crypto currency. Fees can not be added to incoming or outgoing transactions. If you paid a transfer fee, Koinly will calculate it automatically when it matches an outgoing txn to an incoming txn on another wallet. Only use this field for entering trading fees.

Ex. if you bought 1 BTC for 100 USD and paid a 10 USD fee enter this as: 100 USD Sent, 10 USD Fee, 1 BTC Received or as 110 USD Sent, 1 BTC Received and no fee - both are the same. Just don't enter fee if it's already included.

Labels

Labels can only be added on incoming or outgoing transactions (not on trades). Koinly allows the following labels for outgoing transactions

  • gift
  • lost
  • cost

The following labels are allowed for incoming transactions

  • airdrop
  • fork
  • mining
  • staking
  • other_income

Learn more about the labels.

 

 

 

FAQ

How can I import a Transfer?

You can not import any transfers between wallets, instead you need to add an incoming transaction into the "receiving" wallet and an outgoing transaction into the "sending" wallet. Koinly will then match these two transactions and turn them into a single Transfer transaction automatically. Learn more

 

Can I import the same file again without duplicates?

If you need to import the same file again, this can be done without worrying about duplicates. Koinly uses the 'txhash' field to ignore already imported transactions. If this field is missing Koinly will calculate a unique hash based on the row values.

  

Can I import Excel (XLS, XLSX) files or does it have to be CSV?

Koinly can handle these files too but if you encounter some errors (due to encoding etc) just export the file to csv (make sure it is comma delimited!).

 

Error: "Zip end of central directory signature not found"

If you are getting this error when trying to import a file to Koinly, follow these steps:

  1. Open the file in a text editor (not excel!) and remove any invalid lines or quotes. 
  2. Then go to Google Sheets > create a Blank document > paste the csv data into the first column "A". 
  3. Then click on the "A" column to select all rows. Next click on Data > Split text to columns in the menu. 
  4. Your data should now be displayed in separate columns unless the file still contains bad data/quotes. 
  5. Now click on File > Download > Comma separated values (csv) and upload the downloaded file to Koinly.
Did this answer your question?