Skip to main content

DEGIRO portfolio tracking and visualization application

Project description

DEGIRO Portfolio Tracker

A desktop application that helps you track and visualize your DEGIRO investment portfolio with beautiful charts and performance metrics.

Portfolio Dashboard Your portfolio at a glance with live prices and performance charts

What Does This Do?

This application takes your DEGIRO transaction exports (the Excel files you download from DEGIRO) and creates an interactive dashboard where you can:

  • See all your stocks in one place - View your current holdings with live prices
  • Track your gains and losses - See how much money you've made or lost on each stock
  • View beautiful charts - Interactive price charts showing your buy/sell transactions
  • Compare against market indices - See how your stocks perform vs S&P 500 and Euro Stoxx 50
  • Monitor multiple currencies - Automatic conversion to EUR for stocks in USD, SEK, GBP
  • Upload new transactions easily - Just click and upload your Excel file

All data is stored securely on your own computer - nothing is sent to external servers.

Screenshots

Portfolio Dashboard

Portfolio Dashboard Main dashboard showing portfolio summary, action buttons, and stock holdings

Individual Stock View

Stock Detail - NVIDIA Detailed charts showing NVIDIA price history, buy transactions, position value %, and market comparison

Installation

Step 1: Install Python

You need Python 3.11 or newer. Download Python here if you don't have it.

To check if you have Python, open Terminal (Mac/Linux) or Command Prompt (Windows) and type:

python --version

Step 2: Install the Application

Open Terminal (Mac/Linux) or Command Prompt (Windows) and run:

pip install degiro-portfolio

That's it! The application is now installed.

Step 3: Start the Application

Run this command:

degiro-portfolio start

On Windows, if that doesn't work, try:

python -m degiro_portfolio start

You should see a message like "Server started on port 8000".

Step 4: Open the Dashboard

Open your web browser and go to:

http://localhost:8000

You should now see your portfolio dashboard!

Using the Application

Uploading Your Transactions

  1. Export from DEGIRO:

    • Log in to your DEGIRO account
    • Go to Activity → Transactions
    • Export your transactions as an Excel file
  2. Upload to the Application:

    • Click the 📤 Upload Transactions button
    • Select your DEGIRO Excel file
    • Wait for the upload to complete

The app will automatically download prices and display your portfolio!

Updating Stock Prices

Click the 📈 Update Market Data button to refresh all stock prices.

Managing the Server

degiro-portfolio start    # Start the server
degiro-portfolio stop     # Stop the server
degiro-portfolio restart  # Restart the server
degiro-portfolio status   # Check if it's running

On Windows, replace degiro-portfolio with python -m degiro_portfolio in the commands above.

Clearing All Data

To start fresh:

  1. Click the red 🗑️ Purge All Data button
  2. Confirm the deletion

Warning: This permanently deletes all your data.

Understanding Your Portfolio

Portfolio Summary

Shows your total investment value and whether you're up or down overall.

Stock Cards

Each stock shows:

  • Company name - Click to search for investor relations info
  • Number of shares - How many shares you own
  • Current price - Latest price with today's change (▲ up, ▼ down)
  • Position value - Total value in EUR
  • Ticker symbol - Click to view on Google Finance

Charts

Click any stock card to see:

  1. Price Chart - Historical prices with your buy/sell transactions marked
  2. Position Value % - Shows if you're profitable (above 100% = profit)
  3. Investment Tranches - Performance of each individual purchase
  4. Market Comparison - How your stock compares to S&P 500 and Euro Stoxx 50

Features

  • Import DEGIRO transaction exports (Excel files)
  • Upload new transactions via web interface
  • Automatic historical price downloads
  • Live exchange rate conversion (EUR, USD, SEK, GBP)
  • Interactive candlestick charts with transaction markers
  • Portfolio performance tracking
  • Market index comparison (S&P 500, Euro Stoxx 50)
  • Multi-currency support with automatic conversion
  • One-click market data updates

Data Privacy

All your financial data stays on your computer:

  • ✅ Data stored locally in degiro-portfolio.db
  • ✅ Only connects to internet for stock prices
  • ❌ Does NOT send your transaction data anywhere
  • ❌ Does NOT require creating an account

Troubleshooting

The server won't start

  • Make sure port 8000 isn't already in use
  • Check if it's running: degiro-portfolio status
  • Try restarting: degiro-portfolio restart

My stocks don't show prices

  • Click the "Update Market Data" button
  • Check your internet connection

The upload fails

  • Make sure you're uploading a DEGIRO transaction export (Excel format)
  • Verify the file isn't corrupted

I see a "Connection refused" error

  • The server isn't running - start it with: degiro-portfolio start

Getting Help

If you encounter issues:

  1. Check the Troubleshooting section above
  2. Visit the GitHub Issues page

License

See LICENSE file for details.

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

degiro_portfolio-0.3.5.tar.gz (5.5 MB view details)

Uploaded Source

Built Distribution

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

degiro_portfolio-0.3.5-py3-none-any.whl (53.8 kB view details)

Uploaded Python 3

File details

Details for the file degiro_portfolio-0.3.5.tar.gz.

File metadata

  • Download URL: degiro_portfolio-0.3.5.tar.gz
  • Upload date:
  • Size: 5.5 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for degiro_portfolio-0.3.5.tar.gz
Algorithm Hash digest
SHA256 6d76446cafb3da19be5d6ffd042805f89771e5b64be943074893f43fd0be85e2
MD5 b1102a0d85d0cd22d1cf037941d19a45
BLAKE2b-256 8de33154003d174d722bfa881bbbf40fec37eefd6f8ac7d4339ca52f52eeadaa

See more details on using hashes here.

Provenance

The following attestation bundles were made for degiro_portfolio-0.3.5.tar.gz:

Publisher: publish.yml on jdrumgoole/degiro_portfolio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file degiro_portfolio-0.3.5-py3-none-any.whl.

File metadata

File hashes

Hashes for degiro_portfolio-0.3.5-py3-none-any.whl
Algorithm Hash digest
SHA256 c927b1c96eb5d5cb52aa9cf752afb334f6e7504a9f0fd42c7c7e317388ba8f35
MD5 e3c84327f55fa5116624393526ac4ec8
BLAKE2b-256 81f9c2acb6ac15a39401b972e0e81fd933ec4c5e0a07bb3cad2770279e50679e

See more details on using hashes here.

Provenance

The following attestation bundles were made for degiro_portfolio-0.3.5-py3-none-any.whl:

Publisher: publish.yml on jdrumgoole/degiro_portfolio

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

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