nordpy 0.1.0

Interactive TUI for browsing and exporting Nordnet financial data

nordpy

A terminal UI for browsing and exporting your Nordnet portfolio data.

---

[!CAUTION] Disclaimer — This tool is provided as-is, with no warranty of any kind. Use it at your own risk. The author assumes no liability for any loss, damage, or misuse arising from the use of this software. You are solely responsible for securing any exported data and ensuring it is only accessible to you.

Features

• Browse accounts, balances, holdings, transactions, trades, and orders
• Export data to CSV, Excel, or DuckDB
• Session persistence with automatic re-authentication
• Headless export mode (no TUI) for scripting
• SOCKS5 proxy support

How It Works

nordpy authenticates with Nordnet through the same MitID flow your browser uses — it simply performs the login via Nordnet's API directly from the terminal, rather than through a web page. Once authenticated, it fetches your portfolio data using Nordnet's standard API endpoints.

[!IMPORTANT] Privacy — nordpy does not collect, transmit, or store any of your personal information. Your credentials are sent directly to MitID and Nordnet — never to any third-party server. Session cookies are saved locally on your machine (with 0600 permissions) solely to avoid repeated logins. No telemetry, analytics, or external services are involved.

Requirements

• Python 3.13+
• uv package manager
• A Nordnet account with MitID (Danish)

Installation

git clone https://github.com/kiliantscherny/nordpy.git
cd nordpy
uv sync

Usage

Interactive TUI

# MitID App approval (default)
uv run nordpy --user <your-mitid-username>

# Force re-authentication (ignore saved session)
uv run nordpy --user <your-mitid-username> --force-login

[!NOTE] The first time you log in, you will be prompted to enter your CPR number as part of the MitID verification process. This is a one-time step required by MitID to link your identity — subsequent logins will skip this.

Headless Export

uv run nordpy --user <your-mitid-username> --export csv
uv run nordpy --user <your-mitid-username> --export xlsx
uv run nordpy --user <your-mitid-username> --export duckdb

Exported files are saved to the exports/ directory.

[!WARNING] Exported files contain sensitive financial data. Make sure the exports/ directory is not shared, synced to public cloud storage, or committed to version control. Keep your exports in a secure location accessible only to you.

Keybindings

Key	Action
Enter	Select account / drill into detail
e	Export current view
r	Refresh data
q / Esc	Quit

Development

# Install dev dependencies
uv sync --dev

# Run tests
uv run pytest

# Run tests with coverage
uv run pytest --cov=nordpy --cov-report=term-missing

# Lint
uv run ruff check src/

# Type check
uv run ty check src/

License

This project is licensed under the MIT License.

Acknowledgments

This project includes code from MitID-BrowserClient by Hundter, licensed under the MIT License.