Controtto

📊 Controtto

A self-hosted, P&L tracker made with Go, HTMX and no JavaScript. Controtto, keeps track of your transaction saving it in a sqlite file, and returns all sorts of calculations including:

• Avg. Buy price
• Current asset value
• Transaction history
• Import / Export transaction (see sample)
• Profit & Loss

In order to fetch the price of an asset, Controtto relies on mainly 4 APIs (see code).

• Binance - Public API, no token needed.
• BingX - Public API, no token needed.
• Alpha Vantage - Stocks, free but short rate limit. (get an token and set CONTROTTO_AVANTAGE_TOKEN)
• Tiingo - Stocks, crypto and Forex. (create account/token and set CONTROTTO_TIINGO_TOKEN)

Demo

You can also check out the demo at demo.contre.io, the database resets every hour.

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

All configurations are set in the .env file and passed as environment variables. Variables CONTROTTO_PORT and CONTROTTO_DB_PATH are available.

Build and Run

Development env

and access localhost:3000

Run with Podman

A Container image is available on Docker's public registry. If you want to use Docker, simply replace podman with docker.

Run tests

TODO

• More tests
• Wrappers for logging and metrics would be nice as well.
• Add Accounts to keep track of the total net worth.
• Remove all the CSS and use custom style.css + Tailwind CDN.