OpenSea Mint Tracker

Tracks live and upcoming OpenSea Drops and emits the collection name, network, and OpenSea link.

Run

npm run once
npm run daily
npm run watch
npm run telegram

Useful flags:

node src/tracker.js --once --json
node src/tracker.js --once --notify
node src/tracker.js --daily --digest-hour 8 --time-zone UTC
node src/tracker.js --telegram-bot
node src/tracker.js --watch --interval 30
node src/tracker.js --once --pages 3
node src/tracker.js --once --all

By default, the tracker focuses on cards that look like active mint opportunities. Use --all to include every collection card found on the OpenSea Drops page.

Alerts

Newly discovered drops are printed to stdout. You can also send alerts to Discord or Telegram:

DISCORD_WEBHOOK_URL="https://discord.com/api/webhooks/..." npm run watch

TELEGRAM_BOT_TOKEN="123:abc" TELEGRAM_CHAT_ID="123456" npm run watch

Send the current results to Telegram immediately:

node src/tracker.js --once --notify

Generic JSON webhook:

WEBHOOK_URL="https://example.com/mint-alerts" npm run watch

Seen drops are stored in data/seen.json, so watch mode only alerts once for each collection/status combination.

Daily mode sends a morning digest for mints whose OpenSea start date is today, then keeps polling and reports any new same-day mint that appears later:

npm run daily

Telegram Commands

Run the command bot:

npm run telegram

Then message your bot:

/current
/today
/upcoming
/all
/status
/help