Skip to main content

Converts NovaDAX CSV reports to formats accepted by Koinly.

Project description

nd2k

Converts NovaDAX CSV reports to formats accepted by Koinly.

PyPI version CI Release Codacy Badge Codacy Coverage Badge

Requirements

  • Python 3.10 or later

Installation and Usage

pip3 install nd2k
nd2k novadax-file.csv

Alternatively, you can use a container image:

[docker|podman] run -v $(pwd):/wdir -w /wdir ghcr.io/thiagoalessio/nd2k ./novadax.csv

Key concepts

Operations and Transactions

  • Each line in the NovaDAX CSV is an Operation.
  • Each line in the Koinly CSV is a Transaction.

Transactions can consist of one or more operations:

  • A "simple" transaction, such as deposits and withdraws have only one operation.
  • A "trade" transaction has three operations (base asset, quote asset, and trading fee).

This script organizes NovaDAX CSV operations into transactions, and outputs a CSV in the Koinly Universal Format.

Base and Quote assets

In a trading pair like BTC/EUR:

  • Base asset (BTC): The asset being bought or sold.
  • Quote asset (EUR): The asset used to price the base asset.

Implementation details

The NovaDAX CSV file must be parsed in reverse order (from the last line to the first) to correctly match trades with their corresponding fees.

Trading fee lines do not specify which trade they belong to, so we infer the relationship based on the fee's currency and the trade type (purchase or sale).

  • For purchases, the fee is charged in the base asset currency.
  • For sales, the fee is charged in the quote asset currency.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nd2k-0.7.2.tar.gz (37.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nd2k-0.7.2-py3-none-any.whl (9.1 kB view details)

Uploaded Python 3

File details

Details for the file nd2k-0.7.2.tar.gz.

File metadata

  • Download URL: nd2k-0.7.2.tar.gz
  • Upload date:
  • Size: 37.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for nd2k-0.7.2.tar.gz
Algorithm Hash digest
SHA256 32daec52fa96bd1e8446ce25bdf32611958d49363b17ccd5b84dcede401d7b13
MD5 cd93d4eaa6f573b5e609f9e561563bdd
BLAKE2b-256 af1bd0c5cfa88a43766955bc75c2116434cb578a68119f55c154b1b4e73b3572

See more details on using hashes here.

File details

Details for the file nd2k-0.7.2-py3-none-any.whl.

File metadata

  • Download URL: nd2k-0.7.2-py3-none-any.whl
  • Upload date:
  • Size: 9.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.32.3

File hashes

Hashes for nd2k-0.7.2-py3-none-any.whl
Algorithm Hash digest
SHA256 e2114c31227ad37c98dce43d6bc37786d7e9540cecee9629ba0c0b8f89180e8e
MD5 6c96641df0c649e0ccc9651cb9621a8f
BLAKE2b-256 1277037ef3ef443a0ac29d3a716c8dfd1c983b5fd1a4f35f602cfcac2bc2aafc

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page