{"uid":"cap_aeNESL8o9WXYU5EhK0cUl","slug":"nft-collection-recent-sales-03146eda","name":"NFT Collection Recent Sales","description":"Recent sales for an NFT collection (or specific token) on any of 5 chains, ordered descending by block. Returns buyer, seller, marketplace (OpenSea/LooksRare/X2Y2/Blur), price (units + wei), protocol/royalty fees, tx hash, block, and quantity for ...","url":"https://agent402.tools/api/nft-sales","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["contract"],"properties":{"limit":{"type":"number","description":"Max sales to return (1-100, default 20)."},"network":{"type":"string","description":"Chain: ethereum, base, polygon, arbitrum, optimism (default ethereum)."},"tokenId":{"type":"string","description":"Optional: limit sales to a specific token ID."},"contract":{"type":"string","description":"NFT contract address (0x-prefixed 40-hex)."}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"count":1,"sales":[{"buyer":"0xbuyer...","seller":"0xseller...","txHash":"0xabc...","tokenId":"1234","logIndex":42,"priceWei":"12500000000000000000","quantity":"1","tokenType":"ERC721","priceUnits":12.5,"blockNumber":19000000,"marketplace":"seaport","priceCurrency":"ETH","royaltyFeeWei":"312500000000000000","protocolFeeWei":"0","marketplaceAddress":"0x00000000006c3852cbef3e08e8df289169ede581"}],"source":"alchemy-nft-v3","network":"ethereum","pageKey":null,"tokenId":null,"contract":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YGK-Eoiun_aBKnGll-sZ_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns recent NFT sales for a given contract (or specific token) across 5 chains, including buyer, seller, marketplace, price, fees, and transaction metadata.","exampleAgentPrompt":"Can you pull the last 30 sales for the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum, so I can see the buyer, seller, price in ETH, and which marketplace each trade happened on?","exampleUseCases":null,"resultDescription":"Returns an array of recent NFT sale records ordered descending by block, each containing buyer address, seller address, marketplace name (OpenSea, LooksRare, X2Y2, or Blur), sale price in token units and wei, protocol fee, royalty fee, transaction hash, block number, and quantity sold.","failureModes":["Invalid or non-checksummed contract address returns a 400 error","Unsupported network name returns a validation error","No sales found for the given contract or token returns an empty array","Token ID not found in the collection returns an empty result","limit out of range (below 1 or above 100) returns a validation error","Network congestion or chain indexer lag may return stale or incomplete data"],"whenToPreferThis":"Use this endpoint when you need granular, per-transaction NFT sales data including buyer/seller addresses, specific marketplace attribution, and fee breakdowns across Ethereum, Base, Polygon, Arbitrum, or Optimism. Prefer this over generic NFT floor-price endpoints when you need trade history, not just current pricing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T13:12:04.562Z","isFirstParty":false}