Grail Trait Alert Tool

WHAT IT DOES

Grail Trait Alert Tool is your NFT treasure hunter that watches for specific high-value trait combinations across NFT collections. You define your own "grail" criteria—for example, "Background: Gold + Body: Legendary + Accessory: Crown"—and the tool continuously monitors listings and inventory for NFTs matching these exact trait combinations. When a grail NFT is detected, the tool sends immediate alerts and visually highlights the matching NFT on the page. You can set price thresholds per grail to only be notified when a matching NFT is listed at or below your target price. The tool tracks historical matches and maintains an alert cooldown system to prevent notification spam.

WHERE IT RUNS

This script runs on all major NFT marketplaces including OpenSea (opensea.io), Blur (blur.io), LooksRare (looksrare.org), Zora (zora.co), Rarible (rarible.com), and Foundation (foundation.app). It works on collection pages, individual NFT detail pages, and any page displaying NFT cards with trait data.

HOW TO USE

Install the script through the BotGentz userscript manager. Click "Connect Wallet" to link your EVM wallet extension. Navigate to the NFT collection you want to monitor. In the panel, define your grail by entering a name, trait combinations (format: "Category: Value, Category: Value"), and optionally a maximum price in ETH. Click "Add Grail" to save it. The tool automatically scans the page for matching NFTs and highlights them with a golden badge. Enable auto-monitor to continuously scan as you browse. When a grail is found, you'll receive a browser notification and the NFT will be highlighted. Use the "Grails" list button to copy all your active grail definitions.

TRAIT-BASED GRAIL DETECTION ENGINE WITH PRICE THRESHOLD FILTERING

Unlike simple keyword search tools, this tool implements a precise trait-based matching engine that validates NFT traits against user-defined criteria with 100% accuracy. The engine extracts trait data from NFT elements using adaptive DOM parsing that handles multiple marketplace layouts, then performs exact match validation on every defined trait category-value pair. Each grail definition can include an optional price threshold, which filters out matches that are priced above the user's target—ensuring you only get alerts for grails that are actually attainable. The system includes an intelligent alert cooldown mechanism (default 1 hour) that prevents repeated notifications for the same grail NFT across multiple page views, reducing noise while ensuring you never miss a new listing. Highlighted NFTs receive a golden border, a "⭐ GRAIL" badge, and are tracked in the panel's match history for easy reference.

THE PANEL

The floating panel is fully draggable and snap-to-edge enabled. You can collapse it to a compact bubble when not in use, resize it to your preferred dimensions, and it remembers its position across page loads using persistent storage. Press Escape to quickly dismiss the panel. The panel displays your active grail definitions, recent matches, notification status, and monitoring state.

PLEASE NOTE

This script requires the free BotGentz extension to be installed in your browser—it does not run as a standalone extension. The tool cannot detect grail NFTs that are not visible on the current page and relies on the page exposing trait data in a detectable format. Trait combination matching is exact—near-matches will not trigger alerts. No user data is collected or transmitted—all grail definitions and alert history stay local in your browser storage. The tool provides visual assistance for NFT hunting but does not constitute investment advice or guarantee that grail NFTs will be accurately detected on all marketplace layouts.