baby636 / algorand_txn_csv_exporter

Export all transactions for an Algorand wallet (including all ASAs like YLDY, Smile, Akita, Opulent, Lofty, etc.) to a CSV file. Intended to assist with filing taxes.

ALGORAND TRANSACTION CSV EXPORTER (works for all ASAs like YLDY, etc.)

What does it do?

This script will export all transactions for an algorand wallet to a CSV file.

All ASAs (Algorand Standard Assets) in the Algorand wallet will be included in the export. This includes assets like Yieldly (YLDY), Smile Coin (SMILE), Algogems (GEMS), Akita, Lofty, etc....

It is intended to assist with filing taxes. For example, I used it to help find Yieldly (YLDY) and other ASA defi activity that wasn't automatically imported by Koinly.io (a crypto tax web service).

It uses the v1 API from algoexplorer.io (which is free and doesn't require any special credentials)

How to use it:

Simply update the wallet variable with the wallet address(es) you're interested in, and then run the script.

An active internet connection is required, since the code leverages the algoexplorer.io API to read the transactions from the blockchain

The packages used by the code are common ones, but you may need to install them if you don't already have them: pandas, pandas.io.json, requests, datetime, and numpy

Additional Notes:

The last several columns in the export that start with "z_" are fields I added to the API feed at the end. They are the most commonly used fields, and should help you find what you're looking for more easily.

Optionally, you can update the timezone adjustment variable with the number of hours your timezone is from UDT (not required)

The datetime fields that start with "z_" are in the format that Excel uses. Simply change the format mask in Excel for these fields to datetime to see it formatted.

What other options exist to download transactions?

The official algo wallet (only available via phone app at the time of this repo's creation) will allow CSV exports, if you want to put your wallet on your phone. I didn't want to do this.

This other github repo does something similar but attempts to group transcations together. I prefer raw exports instead. Here's a link if you want to check out their approach: https://github.com/HashingSlash/AlgoCSV

Did this script help you? Want to tip me?

I hope this helped you; It helped me too! If you feel inclined to tip, here is an Algo wallet address I set up specifically for tips (not necessary but certainly welcome!):

5Q2RGRRXLC3643TFP22Y5LITE5P3SPQLZO2U4KLDALLMUMZWCOEFVEKQEQ