shield_lock
JinDaGe
← Back to skills
extension
Category: Data & AnalyticsNo API key required

Nft Floor Price Monitor

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

personAuthor: fuzzyb33shubclawhub
open_in_newRepositorydownloadDownload package

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 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