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