batch_purchase
Buy up to 20 SPECIFIC listed ENS names in a SINGLE Seaport transaction, across NameWhisper, OpenSea, AND Grails listings.
Use this when the user names the exact names to buy. To buy the cheapest N names in a category/collection (a floor sweep), use the 'sweep' tool instead.
It's one signature and amortizes gas, far cheaper than calling purchase_name once per name. For each name it picks the cheapest listing (NameWhisper, OpenSea, or Grails), loads its Seaport order, and packs them into one fulfillAvailableAdvancedOrders call. NFTs are delivered directly to the buyer's wallet. Seaport skips any order that sold/cancelled since discovery and refunds the excess — partial fills are safe. The response lists which names made the batch (with marketplace + price) and which were dropped.
Any listing that can't be batched (e.g. a rare restricted-zone Seaport order) is returned in 'failed' — buy those individually with purchase_name. For a single name, purchase_name is also fine.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| names | Yes | Array of ENS names to buy (e.g. ["coffee.eth", "tea.eth"]). Max 20 per batch. | |
| walletAddress | Yes | Buyer wallet address — receives all purchased names. |