0.1.2 • Published 6 years ago

zcom-report v0.1.2

Weekly downloads
1
License
MIT
Repository
-
Last release
6 years ago

This is an import script for getting zcom transactions into the CoinTracking.info site. It also includes a Poloniex history parser that groups orders by order number and reformats deposit/withdrawal history in the standard CoinTracking csv format.

CoinTracking is a portfolio website for tracking cryptocurrency assets. They have lots of exchanges and blockchains already integrated with the site to import automatically, but zcom is not one of them. However, they do have a "Bulk CSV Import" option to add in data from different exchanges that don't have a dedicated import option.

This script uses the zcomjs-ws library to make a connection to the zcom blockchain, fetches all transactions for a given user, and converts it to a CSV file that can be imported into CoinTracking.

cc-by-sa

Usage

This script requires Node to run; install Node locally and run:

npm install
npm start myUsername [debug] [no_grouping] [op_type_filter]

Replace myUsername with the zcom user you wish to make a report for. Since zcom data is completely open, there are no login credentials needed to get a full transaction report on any user.

The debug, no_grouping and op_type_filter parameters are optional. debug = true|false, default = false no_grouping = true|false, default = false op_type_filter = transfer, fill_order, etc, default=none

Running the script will create a {username}-bts-transactions.csv file in the output folder of the project. Head to the CSV Import screen of CoinTracking (Enter Coins > Bulk Imports > CSV Import) and select that CSV file as the target.

Automating multiple accounts

If you have several accounts you can rename run_accounts_example.sh and input your desired accounts there as shown. Then run it using: . ./run_accounts.sh

This will fetch data for all accounts and generate a file called all-merged.csv in the root folder. Instead of importing all the different files manually you can import this file directly in Cointracking as explained above.

Poloniex history parser

If you prefer to have Poloniex transactions grouped by order number (instead of tens or hundreds of entries per order), you can use the poloniexParser script. First export your trade, withdrawal and deposit history from Poloniex and save it in the root folder of the project. Then run:

node poloniexParser.js

This will generate three files in the output folder that can be imported directly into Cointracking. Deposit/withdrawal is the same CSV format as the BTS history, trade history using manual Poloniex Exchange import.

Caveats

An important limitation right now is that the API node used needs to be configured to store all operation history. That means setting the max-ops-per-account parameter in config.ini to a high value, I've used max-ops-per-account = 200000 successfully for my own accounts. A replay of the blockchain is necessary after changing this parameter.