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 CodeQL Codacy Badge Codacy Coverage Badge

Requirements

  • Python 3.10 or later

Installation and Usage

pip3 install --upgrade 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.8.1.tar.gz (39.1 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.8.1-py3-none-any.whl (8.5 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for nd2k-0.8.1.tar.gz
Algorithm Hash digest
SHA256 da88cf052098635061513a4384946230f161e8775cb7e0fdb20f607747a92159
MD5 569a5f2ade45b8ce5a786639a90a3437
BLAKE2b-256 83b3f30a43061d11c989db3ac39ec13fe1ea3ed5e72cede139f8598af87c9955

See more details on using hashes here.

File details

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

File metadata

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

File hashes

Hashes for nd2k-0.8.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a0cf8c987b5f4f05a9c0ee226f534349a60abc9b1db1e3a1e02ac736829cb025
MD5 a4546b39913594dd633b608441d7c389
BLAKE2b-256 cd2df362123fb5de588be374a580c7ad6e89b39c517acad8f96bb4ffa3a5f8f2

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