New Token Listing Alert

WHAT IT DOES

New Token Listing Alert watches the current page for new token listing events on DEXs or centralized exchanges by monitoring factory contract events (e.g., PairCreated, NewToken) and reading token metadata, and triggers alerts when a new token is listed matching user-defined criteria (e.g., token name, symbol, or minimum liquidity). It helps you discover new tokens early and filter out spam or low-quality listings.

WHERE IT RUNS

This tool operates as a userscript within the BotGentz extension framework, running directly in your browser on any website. It works on any EVM-compatible blockchain page—Ethereum, Polygon, Arbitrum, Optimism, and more—where DEX factory contracts are deployed. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you monitor the blockchain for new token opportunities.

HOW TO USE

Enter the DEX factory contract addresses you want to monitor in the "DEX Factory Setup" section (comma-separated). Configure your token filters in the "Token Filters" section: enter a token name or symbol filter to focus on specific projects, and optionally set a minimum liquidity threshold to avoid spam tokens. Configure your alert settings: set the refresh interval and toggle desktop notifications on or off. Click "Start Token Monitoring" to connect your real wallet extension, which will begin scanning for new token listings at your specified interval. The panel displays a list of detected tokens with their symbol, name, and factory address. Use "Check Now" for an immediate update, "Clear Token History" to reset the list, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

New Token Listing Alert uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain—no external library required for basic operations. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool gets the current block number and checks for new transactions since the last checked block using eth_getLogs. It filters for PairCreated events (Uniswap-style) or NewToken events from the specified factory contracts. When a new token is detected, it reads the token's metadata (name, symbol, decimals) using eth_call and checks the user's filters. If the token matches the name/symbol filter and meets the minimum liquidity threshold (checked via the pair contract if applicable), it triggers a desktop notification and panel flash, and adds the token to the history list. The tool stores up to 100 recent token detections in GM_setValue for persistence.

THE PANEL

The New Token Listing Alert panel is fully draggable and remembers its position between sessions using GM_setValue. It snaps to the edge of the viewport for a clean interface and can be collapsed to a small icon when not in use. The panel is resizable to accommodate longer content. Press Escape to quickly close or collapse the panel. The design is optimized for productivity with a dark theme, clear visual hierarchy, and responsive controls that adapt to your workflow.

PLEASE NOTE

This tool requires the free BotGentz extension installed in your browser and a real EVM wallet extension (MetaMask, Rabby, etc.) already installed. EVM chains only—this does not work on non-EVM blockchains. The tool cannot detect token listings if the factory contract does not emit standard events, cannot read token metadata if the token contract does not expose the required view functions, cannot detect off-chain listings, and cannot monitor private mempool transactions. No private keys are stored or transmitted—all data is read-only from the blockchain. Always verify the factory addresses and token contracts before interacting with newly listed tokens.