0caa8db0b3c7bb36ca64f1275d409d1904200402
Denormalized read table with id, event_id, occurred_at, wallet, sats, fee_sats, and amount_eur. Projected on event creation and rebuildable via POST /api/buys/rebuild. Fiat amounts converted to EUR using Frankfurter rates. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
btcdata
Bitcoin data backend service. Fetches BTC prices from Binance (WebSocket) and Kraken (HTTP polling), stores them in PostgreSQL, and exposes a JSON API with WebSocket for live price streaming.
API
| Endpoint | Description |
|---|---|
GET /api/price/ws |
WebSocket — sends HTML fragments with live price updates (HTMX-compatible) |
GET /api/price/latest |
Latest price as JSON |
GET /api/health |
Health check |
Quick Start
# Local dev (requires PostgreSQL)
cp .env.example .env # edit JDBC_URL
make run # starts on port 4100
# Docker
docker compose up -d # starts on port 4101
Environment Variables
| Variable | Default | Description |
|---|---|---|
BTCDATA_PORT |
4100 |
HTTP server port |
JDBC_URL |
— | PostgreSQL connection string |
CORS_ORIGIN |
* |
Allowed origin for CORS headers |
Data Sources
- Binance — WebSocket trade stream (
btcusdt@trade), throttled to 5s writes - Kraken hourly — OHLC candles polled at HH:01:00 UTC
- Kraken daily — OHLC candles polled at 00:01:00 UTC
Tech Stack
Clojure · Kit · Undertow · Reitit · PostgreSQL · conman · Migratus
Languages
Clojure
97.5%
Shell
1.3%
Dockerfile
0.8%
Makefile
0.4%