- name
- nft-floor-price-monitor
- description
- Monitor NFT collection floor prices and send alerts via Discord DM when floors hit target levels. Use when the user wants to (1) check the current floor price of an NFT collection (Blur, OpenSeafloor, NFTfi, etc.), (2) set floor price alerts, (3) compare multiple collections, (4) track floor price history, (5) DM alerts to Discord when floors cross thresholds. Triggers: "NFT floor", "floor price", "monitor NFT", "NFT alert", "collection floor", "Blur floor", "OpenSea floor", "NFT portfolio", "floor alert".
- version
- 1.0.0
- author
- 9527Craft
- price
- 49
- category
- nft
- tags
- [nft, floor-price, blur, opensea, web3, monitor, alerts, discord, trading]
- license
- MIT
NFT Floor Price Monitor
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 jsonCore Features
- Live Floor Price — Current floor from multiple sources (Blur, OpenSea)
- Price Alerts — Get a Discord DM when floor crosses your target
- Multi-Collection Compare — Compare up to 5 collections at once
- Direction Triggers — Alert when floor goes above OR below target
- JSON Output — For automation pipelines:
--output json
Scripts
scripts/floor_monitor.py— Main script. Run standalone withuv 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
- Set
DISCORD_WEBHOOK_URLenv var, or pass--discord-webhook https://... - Use
--discordflag to enable DM alerts - 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