

| Parameter | Type | Description |
|---|---|---|
maxPages | integer | Max OpenSea pages to walk (default 30, max 60). |
budgetEth* | number | ETH budget for the sweep (0 < x ≤ 10000). Legacy alias: `budget`. |
collection* | string | OpenSea collection slug (lowercase a-z, 0-9, dash). Legacy alias: `slug`. |
| Parameter | Type | Description |
|---|---|---|
slug* | string | Collection slug that was quoted |
avgEth* | number | Average price per acquired NFT in ETH |
contract | object | NFT contract address (lowercased) inferred from the first listing |
floorEth* | number | Cheapest live listing seen, in ETH |
tokenIds* | string[] | Token IDs that would be acquired, cheapest-first |
totalEth* | number | Total ETH spent across the swept set |
budgetEth* | number | Echoed input budget in ETH |
fetchedAt* | string | |
ceilingEth* | number | Price of the last (most expensive) NFT acquired |
sweptCount* | integer | Number of NFTs that would be acquired |
slippagePct* | number | (ceiling/floor - 1) * 100 |
listingsSeen* | integer | Raw listings observed across the walk |
pagesScanned* | integer | Pages of OpenSea best-listings walked |
uniqueTokens* | integer | Distinct token IDs observed (after dedup) |
budgetUsedPct* | number | (totalEth / budgetEth) * 100 |