NFT Trait-Based Auto-Buyer

WHAT IT DOES

NFT Trait-Based Auto-Buyer watches the current page for NFT listings, reads the token metadata and trait data from the contract via eth_call, and automatically buys NFTs that match user-defined trait criteria (e.g., specific attributes, rarity score, or trait combinations) at or below a target price, with options to set max budget and auto-buy limits. It helps you acquire NFTs with specific traits without manual monitoring.

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 NFT marketplaces and trait data are accessible. The tool integrates seamlessly into your workflow, appearing as a draggable panel that stays accessible as you hunt for specific NFTs.

HOW TO USE

Enter the marketplace contract address and the NFT contract address in the "Contract Setup" section. Define your trait criteria in JSON format in the "Trait Criteria" section (e.g., {"Background": 50, "Color": [10,20,30], "Pattern": {"min": 40, "max": 60}}). Set your target price per NFT, max budget, and max buys per session. Set the refresh interval and toggle auto-execute on or off. Click "Connect & Start Auto-Buy" to connect your real wallet extension, which will begin scanning for matching NFTs at your specified interval. The panel displays your balance, buy count, budget spent, and any matches found. Use "Scan Now" for an immediate scan, "Reset Counter" to reset the buy count, or "Stop Monitoring" to disconnect.

TECHNICAL OPERATION

NFT Trait-Based Auto-Buyer uses raw JSON-RPC calls via window.ethereum.request() to interact with the blockchain. It loads ethers at runtime using a simple script tag injection for ABI encoding and contract interactions. The tool reads token metadata and trait data using eth_call with the appropriate view functions. It reads listing prices from the marketplace contract using eth_call. The tool checks the user's wallet balance using eth_getBalance. When a listing matches the user-defined trait criteria and is at or below the target price, the tool submits a purchase transaction using eth_sendTransaction. The tool tracks the buy count and total spent to enforce the max budget and max buys limits. The trait criteria support exact matches, arrays of acceptable values, and min/max ranges.

THE PANEL

The NFT Trait-Based Auto-Buyer 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 read trait data if the contract does not expose a view function for it, cannot read listing prices if the marketplace does not expose a view function, cannot execute if the user lacks sufficient funds, and cannot predict if the NFT will be bought before the transaction is submitted. No private keys are stored or transmitted—all signing happens directly through your wallet extension. Always verify the trait criteria and price limits before enabling auto-execute.