NFT Auction Settlement Claimer

WHAT IT DOES

NFT Auction Settlement Claimer lets you settle completed NFT auctions by claiming the NFT if you are the winning bidder, or claiming a refund if you were outbid. When an auction ends, the marketplace holds the NFT and the winning bid amount in escrow until settlement. Instead of manually checking each auction and submitting separate settlement transactions, you add all the auctions you participated in, verify their settlement status, and settle them all at once. This is essential for NFT bidders who want to efficiently claim their winnings or recover their funds after multiple auctions.

HOW TO USE

Connect your EVM wallet and select the network. Enter the marketplace contract address (e.g., OpenSea Seaport, Blur) where you participated in auctions. In the input area, list each auction you want to settle using the format: contract,tokenId,auctionId. Click "Add auctions" to load them, then click "Check settlement" to verify the status of each auction—the tool checks whether the auction has ended, whether you won or were outbid, and whether it has already been settled. Review the status, then click "Settle claims" to process all claimable settlements. The tool calls the marketplace's settleAuction() function for each claimable auction, transferring the NFT to you if you won or returning your bid amount if you were outbid.

TECHNICAL MECHANISM

The tool first queries the marketplace contract for each auction's status using a view function that returns the active state, end time, highest bid, and highest bidder. It also checks whether the auction has already been settled. It identifies auctions that have ended and where the connected wallet is either the highest bidder (winner) or has a claimable refund (outbid). It then calls the marketplace's settleAuction() function for each claimable auction, which transfers the NFT to the winning bidder and distributes funds accordingly. The tool uses receipt.effectiveGasPrice for accurate gas reporting and provides progress feedback during the settlement process.

WHAT IT CANNOT SEE

This tool cannot settle auctions that are still active—only ended auctions are eligible for settlement. It relies on the marketplace supporting settlement via its contract interface; marketplaces that do not expose a settlement function are not supported. The tool does not detect auctions where the connected wallet did not participate or where the settlement has already been processed. Gas costs scale with the number of settlements processed, which can be significant for large batches.

PLEASE NOTE

Settlement must be initiated after the auction ends—if you delay, the marketplace may have a timeout period after which you can no longer claim. Ensure you settle your auctions promptly. The marketplace contract must be trusted; verify its security and audit status before use. This tool is for EVM chains only and does not support non-EVM networks.