📊 康特罗托

Name: Controtto
Author: contre95

Controtto 是一个自托管的损益跟踪器，使用 Go、HTMX 和JavaScript编写。它会跟踪您的交易并将其保存在 SQLite 文件中，并返回各种计算结果，包括：

平均买入价
当前资产价值
交易历史记录
进出口交易（见样本）
盈亏

为了获取资产的价格，Controtto 主要依赖于 4 个 API（参见代码）。

Binance——公共 API，无需令牌。
BingX - 公共 API，不需要令牌。
Alpha Vantage - 股票，免费但利率限制较短。（获取代币并设置CONTROTTO_AVANTAGE_TOKEN ）
Tiingo - 股票、加密货币和外汇。（创建帐户/代币并设置CONTROTTO_TIINGO_TOKEN ）

演示

您还可以查看demo.contre.io上的演示，数据库每小时重置一次。

https://github.com/user-attachments/assets/28bf8782-6118-47c0-a94b-085e1a7045b2

所有配置均在.env文件中设置，并作为环境变量传递。变量CONTROTTO_PORT和CONTROTTO_DB_PATH可用。

# Install the dependencies go mod tidy # Set the .env mv .env.example .env # Source the env variables . <(cat .env | grep -v -e '^$' | grep -v "#" | awk '{}')

Related MCP server: Delve MCP

构建并运行

go run ./cmd/main.go # go build ./cmd/main.go to just build it

开发环境

go install github.com/cosmtrek/air@latest # Download air air -c air.toml

并访问localhost:3000

使用 Podman 运行

Docker 的公共镜像仓库中提供了容器镜像。如果您想使用 Docker，只需将podman替换为docker即可。

mkdir data podman container run --rm -p 8000:8000 -v $(pwd)/data:/data contre95/controtto

运行测试

go test -cover ./... # Expected result # ? controtto/cmd [no test files] # ? controtto/src/app/managing [no test files] # ? controtto/src/domain/pnl [no test files] # ? controtto/src/gateways/markets [no test files] # ? controtto/src/gateways/sqlite [no test files] # ? controtto/src/presenters [no test files] # ok controtto/src/app/querying 0.003s coverage: 40.7% of statements