.env.example

# ─── Required ──────────────────────────────────────────────────────────────────

# Postgres connection string. On Railway this is auto-injected when you reference
# the Postgres plugin: DATABASE_URL=${{Postgres.DATABASE_URL}}
DATABASE_URL=postgres://user:pass@host:5432/dbname

# OpenSea API key. https://docs.opensea.io/reference/api-keys
OPENSEA_API_KEY=your_opensea_api_key_here

# X (Twitter) API v2 OAuth 1.0a credentials.
# Create app at https://developer.x.com — see README "X developer setup".
# All four are REQUIRED to post; bot will refuse to start with the X delivery
# disabled if any are missing.
X_API_KEY=your_consumer_key
X_API_SECRET=your_consumer_secret
X_ACCESS_TOKEN=your_access_token
X_ACCESS_TOKEN_SECRET=your_access_token_secret

# ─── Collection registry ───────────────────────────────────────────────────────

# Path to a JSON file listing every collection to track. See collections.example.json.
# When deploying without a writable filesystem (e.g. Railway), set
# COLLECTIONS_JSON instead with the file contents inline.
COLLECTIONS_PATH=./collections.json
# COLLECTIONS_JSON=[{"slug":"pixel-pups","openseaSlug":"pixel-pups","contract":"0x1c75df005dd674630b212ce8106fcab29b1ac1bf","chainId":1,"displayName":"Pixel Pup","emoji":"🐾","communityCallToAction":"The pack is growing","communityUrl":"https://opensea.io/collection/pixel-pups"}]

# ─── Optional tuning ───────────────────────────────────────────────────────────

# Polling cadence for OpenSea events. 4 seconds is a good default — at this
# rate one bot consumes ~900 req/h against /events per collection.
ALERT_POLL_MS=4000

# How far back (seconds) OpenSea HTTP polls look (Pixel Pups / Pup Cup).
OPENSEA_POLL_LOOKBACK_SEC=1800

# Seaport-on-Robinhood lookback for StonkBrokers OpenSea fills. Keep this
# wider than OPENSEA_POLL_LOOKBACK_SEC — marketplace sales are sparse and a
# 15m window routinely misses them while AMM transfers still show activity.
# Default 14400 (4h); DB dedupe prevents double posts on restart.
SEAPORT_RH_LOOKBACK_SEC=14400

# Override the OpenSea API host (rarely needed).
OPENSEA_BASE_URL=https://api.opensea.io

# Set to "false" to skip the auto-migrate-on-startup. Default: migrations run.
RUN_MIGRATIONS=true

# Set to "false" to suppress the "📈 Floor +X.X%" line entirely. Default: line
# appears once the bot has accumulated 24h of floor history.
FLOOR_DELTA_LINE=true