Nft Floor Price Monitor

Monitor NFT collection floor prices across platforms, set target alerts, compare multiple collections, track history, and receive Discord DM notifications.

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

Quick Usage

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

Arg	Description
--collection	Collection slug (e.g. bored-ape, bayc, doodles) — required
--target	Target floor price in ETH for alert
--direction	above or below (default: below)
--discord	Send Discord DM alert when triggered
--discord-webhook	Discord webhook URL (or set env var DISCORD_WEBHOOK_URL)
--compare	Compare N collections at once
--output	text (default) or json

Collection Slugs

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

Collection	Slug
Bored Ape Yacht Club	bored-ape-yacht-club
Mutant Ape Yacht Club	mutant-ape-yacht-club
Doodles	doodles
Azuki	azuki
Clone X	clonex
Others	Check 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