Listing Age Indicator Overlay

WHAT IT DOES

Listing Age Indicator Overlay watches the current marketplace page for NFT listings, reads the NFT's contract address and token ID from the page, reads the listing timestamp and current price from the marketplace or contract via eth_call, calculates the listing age in hours and days, identifies listings that have been active beyond configurable thresholds, and displays an overlay with listing age, price history, and execution recommendations when aged listings are detected. The tool scans the page for NFT listings, reads contract addresses and token IDs, reads listing timestamps and current prices, calculates listing age, identifies aged listings, and provides recommendations.

WHERE IT RUNS

The tool runs as a panel inside your browser on OpenSea marketplace pages at https://opensea.io/*. It works on any OpenSea page displaying NFT listings. The tool connects to your real EVM wallet extension (MetaMask, WalletConnect, or any wallet injecting window.ethereum) to read on-chain data via eth_call and the ethers library loaded at runtime. No data is sent to any external server; all reads happen directly from the blockchain through your wallet provider.

HOW TO USE

Install the BotGentz extension, navigate to OpenSea with your wallet connected, and open the Listing Age Indicator Overlay panel. Set your age threshold in hours (default 24) — the tool will flag listings that have been active for longer than this threshold. Set your price change threshold percentage (default 10%) — the tool will also flag listings with price changes exceeding this threshold. Choose your alert preference — Panel only, Browser notification, or Both. Toggle "Auto-check on page load" if you want the tool to analyze automatically when you open the panel. Click "Scan Age" — the tool scans the page for NFT listings, reads listing timestamps and current prices, calculates listing age, identifies aged listings, and displays a comprehensive analysis with recommendations. When aged listings are detected, the tool triggers alerts with listing age and price change details. Click "Refresh" to manually update the age analysis.

MECHANISM — LISTING AGE DETECTION WITH PRICE CHANGE TRACKING

This tool uses a listing age detection engine that tracks how long NFTs have been listed and monitors price changes. The system first connects to window.ethereum and requests the user's wallet address. It scans the page for NFT listings using DOM selectors for item cards and listing details, extracting contract addresses and token IDs. For each NFT, the tool reads the listing timestamp and current price from the marketplace or contract via eth_call. It calculates the listing age in hours: ageHours = (now - listingTimestamp) / (1000 * 3600). The tool also tracks price changes by comparing the current price against the original listing price. The urgency classification uses a multi-tier system: AGED (ageHours ≥ threshold), PRICE_CHANGED (|priceChange| ≥ threshold), or NORMAL (neither condition met). Recommendations are generated based on the listing age and price changes, helping users identify potential opportunities in aged listings.

THE PANEL

The BotGentz panel is fully draggable, allowing you to position it anywhere on your screen without obstructing the OpenSea interface. It includes per-site position memory, so the panel returns to your preferred location each time you visit the marketplace. Snap-to-edge functionality lets you dock the panel to any side of the browser window. The panel collapses to a compact icon when not in use and expands with a single click. You can resize it to your preferred dimensions, and pressing the Escape key instantly closes the panel. All interactions are smooth and intuitive, designed to work alongside your NFT trading workflow.

PLEASE NOTE

This tool requires the free BotGentz extension and a real EVM wallet extension (such as MetaMask) already installed in your browser. EVM chains only — currently supports Ethereum mainnet. This is a monitoring and analysis tool only — it does not execute purchase transactions automatically. The tool cannot guarantee that the displayed listing age matches the exact moment of execution due to on-chain latency. It cannot account for listing updates or changes. It cannot read listing data from marketplaces not supported by the tool. It cannot verify listing validity or authenticity. It cannot predict future price movements or market trends. It cannot read private wallet information or purchasing intentions. All blockchain reads are performed directly through your wallet provider; no data is stored or transmitted beyond your browser. Websites change their layouts and content structures regularly; while we continuously update the extraction logic, some pages may require script updates. Always verify all NFT details, listing ages, and price history independently before taking any action based on the dashboard.