Lux Pricing API

USD price feed for crypto assets: a cached CoinGecko gateway.

Features

• CoinGecko upstream, keyed or anonymous
• 1-hour cache TTL to minimize API calls
• CoinGecko-compatible /simple/price endpoint
• CORS support
• Docker-ready deployment

Endpoints

Endpoint	Description
GET /health	Health check
GET /price/{token_id}?currency=usd	Single token price
GET /prices?ids=bitcoin,ethereum&currency=usd	Multiple token prices
GET /simple/price?ids=bitcoin&vs_currencies=usd	CoinGecko-compatible format

Usage

# Single token
curl https://price.lux.cloud/price/bitcoin

# Multiple tokens
curl "https://price.lux.cloud/prices?ids=bitcoin,ethereum,solana&currency=usd"

# CoinGecko compatible
curl "https://price.lux.cloud/simple/price?ids=bitcoin&vs_currencies=usd,eur"

Response Format

{
  "id": "bitcoin",
  "symbol": "btc",
  "name": "Bitcoin",
  "price": 97234.56,
  "currency": "usd",
  "change_24h": 2.34,
  "market_cap": 1923456789012,
  "volume_24h": 45678901234,
  "updated_at": "2025-01-24T12:00:00Z",
  "cached": true
}

Development

# Run locally (the key is optional)
export COINGECKO_API_KEY=your-api-key
go run main.go

# Docker
docker compose up -d

Deployment

price.lux.cloud, on lux-k8s.

Tagging vX.Y.Z builds and pushes ghcr.io/luxfi/price:vX.Y.Z (.hanzo/workflows/release.yml). Shipping it is an image.tag edit in luxfi/universe at deploy/lux-cloud/price.yaml, which CD applies. A push to main builds nothing and deploys nothing, by design.

Environment Variables

Variable	Default	Description
COINGECKO_API_KEY	-	Optional. Unset, the service uses the anonymous CoinGecko endpoint and its rate limits. Sent as x-cg-demo-api-key, so a Demo key is what this reaches — see LLM.md.
PORT	8080	Server port

License

MIT © Lux Industries Inc