Ever tried to export your crypto transactions from an exchange only to find out there's missing data? 🙄
...or that the file format is completely different from every other exchange? 🙄
...or that they didn't account for the fees, so your tax is now too high? 🙄
Well, this tool is for you...
Install locally, and with a single command, CryptoCredible will safely and securely fetch all your transaction data, and output a csv file with nothing missing, in a single standard format.
What's better is the output is designed to work perfectly with the amazing open source tax software BittyTax.
- Coinbase
- Coinbase Pro
- ...with more coming soon!
To run CryptoCredible you will first need to install php locally on your system.
For Mac users this is easy.
Install HomeBrew using their instructions here, then install php by entering this command into a Terminal window:
brew install php
Windows is a little more complex.
A few options to get php running on your system:
Once you have setup php locally, you now need to download this package and install the required dependancies using composer. If you don't have composer installed go here and follow the instructions.
To install the dependancies, open up a fresh terminal window, change directory to the root of this project, and run:
composer install
You should be ready to move forward now.
First you need to configure your api connections with your crypto exchange(s) - see below.
Once that's done, open up a terminal window and run the command suitable for your exchange(s):
Login into your Coinbase account to create new api credentials, selecting all the permissions with :read
in them. Paste the credentials into the .env
file at the root of the project directory using the following structure:
COINBASE_API_KEY=[api key here]
COINBASE_API_SECRET=[api secret here]
Then run this command in a terminal window from the root directory of this project:
php cryptocredible sync:coinbase
Login into your Coinbase Pro account and create new view api credentials. Paste them into the .env
file at the root of the project directory:
COINBASE_PRO_API_KEY=[api secret here]
COINBASE_PRO_API_SECRET=[api secret here]
COINBASE_PRO_API_PASSPHRASE=[api passphrase here]
Then run this command in a terminal window from the root directory of this project:
php cryptocredible sync:coinbase-pro
Each command accepts the follow options:
Argument | Shortcut | Description | default |
---|---|---|---|
--output-dir | -o | Provide a dir on local file system to output csv to | ./../ |
--json | -j | Provide a json file rather than fetch txs via api. | n/a |
--dump | n/a | Dump all the transactions fetched via the api into a json file. | n/a |
Yes, but you are using it without warranty, and at your own risk. Having said that, here are some strong points which make this safe:
- It runs locally on your own computer, and you have total control over the data and even the code.
- The exchange connections are configured via the
.env
file using read-only api credentials. These credentials never leave your system in a usable format. - The code is open-source, so feel free to poke around and ensure it's safe. Other people have probably poked around too. Safety in numbers.
Trust but verify.
Please see CHANGELOG for more information what has changed recently.
Please see CONTRIBUTING for details.
If you discover any security related issues, please email [email protected] instead of using the issue tracker.
The MIT License (MIT). Please see License File for more information.