NFT Floor Price Monitor#

Monitor NFT collection floor prices and receive Discord DM alerts when floors hit your targets.

Quick Usage#

bash

uv run python scripts/floor_monitor.py --collection bored-ape --target 80 --discord
uv run python scripts/floor_monitor.py --collection bayc --target 100 --direction below
uv run python scripts/floor_monitor.py --collection doodles --target 10 --output json
uv run python scripts/floor_monitor.py --collection mutant-ape-punks --compare 3 --output json

Core Features#

1. Live Floor Price — Current floor from multiple sources (Blur, OpenSea)
2. Price Alerts — Get a Discord DM when floor crosses your target
3. Multi-Collection Compare — Compare up to 5 collections at once
4. Direction Triggers — Alert when floor goes above OR below target
5. JSON Output — For automation pipelines: --output json

Scripts#

• scripts/floor_monitor.py — Main script. Run standalone with uv run python scripts/floor_monitor.py [args]

Arguments#

ArgDescription--collectionCollection slug (e.g. bored-ape, bayc, doodles) — required--targetTarget floor price in ETH for alert--direction``above or below (default: below)--discordSend Discord DM alert when triggered--discord-webhookDiscord webhook URL (or set env var DISCORD_WEBHOOK_URL)--compareCompare N collections at once--output``text (default) or json

Collection Slugs#

Common collection slugs (slug for URL: opensea.com/collection/{slug}):

CollectionSlugBored Ape Yacht Clubbored-ape-yacht-clubMutant Ape Yacht Clubmutant-ape-yacht-clubDoodlesdoodlesAzukiazukiClone XclonexOthersCheck OpenSea or Blur for the correct slug

Alert Logic#

• --direction below (default): Alert when floor drops to or below target
• --direction above: Alert when floor rises to or above target
• Automatic alert on 24h change > 10%

Discord DM Setup#

1. Set DISCORD_WEBHOOK_URL env var, or pass --discord-webhook https://...
2. Use --discord flag to enable DM alerts
3. The webhook will post an embedded alert message

Technical Notes#

• Uses CoinGecko NFT price data and OpenSea/Blur APIs (no auth required)
• Rate limiting: respect API limits, add delays between requests
• Floor prices are in ETH by default