example.env

# ===========================================
# REQUIRED — Served ETL database (the ONLY database this API reads)
# ===========================================
# Read-only connection to the served user_pool ETL DB. Without it, /api/tickers,
# /api/market-data, and the DexScreener routes return 503.
DATABASE_PG_URL=postgresql://readonly:password@host:5432/database

# TLS to the served DB. Verifies the server cert by default (system CAs, or the
# PEM CA cert CONTENT below for a private CA).
DATABASE_PG_SSL=true
# DATABASE_PG_CA_CERT=
# Encrypt WITHOUT authenticating the server (self-signed/legacy) — stopgap only.
# DATABASE_PG_SSL_NO_VERIFY=true

# ===========================================
# Server
# ===========================================
PORT=3000
NODE_ENV=production
# Reverse-proxy hop count in front of the process; required so per-IP rate limiting
# resolves real client IPs (not the proxy's). 0 = no proxy. Use the exact count.
# TRUST_PROXY_HOPS=1
# Request / keep-alive timeouts in ms (default 300000 each).
# SERVER_REQUEST_TIMEOUT=300000
# SERVER_KEEP_ALIVE_TIMEOUT=300000

# ===========================================
# Trusted API keys (elevated rate limit)
# ===========================================
# Comma-separated opaque secrets sent via the 'X-API-Key' header; each gets its own
# bucket, unknown keys get 401. Per-key limit/min via TRUSTED_RATE_LIMIT_MAX (default 600).
# TRUSTED_API_KEYS=
# TRUSTED_RATE_LIMIT_MAX=600

# ===========================================
# Solana RPC (used by /api/tickers + supply reads)
# ===========================================
# RPCPOOL_RPC_URL takes precedence; SOLANA_RPC_URL is the public fallback.
# RPCPOOL_RPC_URL=
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com

# ===========================================
# Misc
# ===========================================
# Ticker cache TTL in ms (default 55000).
# CACHE_TICKERS_TTL=55000
# Protocol fee rate (0.005 = 0.5%); reported as fee bps on the DexScreener routes.
# PROTOCOL_FEE_RATE=0.005
# Shown on the root info route.
# DEX_FORK_TYPE=Custom
# FACTORY_ADDRESS=
# ROUTER_ADDRESS=
# DAOs excluded from /api/tickers (comma-separated mints). Default: none.
EXCLUDED_DAOS=DMB74TZgN7Rqfwtqqm3VQBgKBb2WYPdBqVtHbvB4LLeV,AE7jPb9jYzbUE5GYJToKvXaRkJL2Q7Mm3Ek6KqyBGuxe,E3BjsvLSFqUqVtDP76qMw4QbETkxvqvg8RTSbRZxWCK4,CnUUCGbSrAoaJniPifRU8zHRZ6e5uGRVSpCEj2WMeeSv,CLoqV77NtkbrsvtCRDP1vdYxgPZua3nnh7gCNPLzDQQ8,CJCgDqiDtkQvwXT2iiyY7QVajKLH3VRVbcsNQgtttrHn,651uV1hcd7SprwwkumFfkWtx5WrnD53awpjduGtGsHzS,4rW6iVKUq1RWYQ1VBTrjvP9FL4G3Sn7mBj7Yg12kuckv,Eo1BLMVRLJspjP5dDnwzK1m6FxMUcQDG6kDA8CjWPzRW,CTYxPujxrXiiqwG3gSBVNKuBk8u7mPG9qVMUc4aT1L8u,EbcsPbXZa81xUunDSmzYrcAWGURxcZB6BTkgzqvNJBZH,BgNq2V6vea2C7Z3cZhDUJTbmN4Y9bKG6dfEPhH19J7Fb,DHjQLd6LCM4yzZ9e8eabyGofDJLjbouqpuX8wh1rQuBs,BQjNtXjZB7b9WrqgJZQWfR52T1MqZoqMELAoombywDi8,j6Hx7bdAzcj1NsoRBqdafFuRkgEU48QeZ1i5NVXz9fF

# ===========================================
# Heartbeat (background self-check) — 0 disables
# ===========================================
# HEARTBEAT_INTERVAL_MS=60000
# HEARTBEAT_MAX_DATA_AGE_SECONDS=21600

# ===========================================
# Alerts (Telegram webhook relay)
# ===========================================
# ALERT_WEBHOOK_URL=
# ALERT_WEBHOOK_SECRET=