{"uid":"cap_afgdD2fB7GeMsEUvZjhjh","slug":"x402-deployer-x402-deployer-workers-dev-7787b4da","name":"NFT Collection Floor & Sales Data via Reservoir","description":"NFT collection floor + recent sales via Reservoir. Ethereum / Base / Arbitrum / Optimism / Polygon. Floor, top bid, 24h/7d/30d volume + change, ranks, recent sales.","url":"https://x402-deployer.x402-deployer.workers.dev/nft-floor","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":{"required":["collection"],"properties":{"collection":{"type":"string","description":"CoinGecko NFT collection slug, e.g. 'bored-ape-yacht-club'. The only input the handler reads."}}},"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","properties":{"floor_usd":{"type":"integer"},"floor_native":{"type":"number"},"market_cap_rank":{"type":"integer"}}}}}}},"responseSchema":null,"example":{"request":{"input":{"body":{"chain":"ethereum","collection":"pudgy-penguins","recent_sales_limit":5,"include_recent_sales":true},"type":"http","method":"POST","bodyType":"json"}},"response":{"name":"Pudgy Penguins","slug":"pudgy-penguins","chain":"ethereum","image":"https://coin-images.coingecko.com/nft_contracts/images/38/small/pudgy.jpg?1730778323","links":{"discord":"https://discord.gg/pudgypenguins","twitter":"https://twitter.com/pudgypenguins","homepage":"https://www.pudgypenguins.com/"},"symbol":"PPG","floor_usd":6684.87,"attribution":"Data: CoinGecko (coingecko.com)","banner_image":"https://coin-images.coingecko.com/nft_contracts/images/38/pudgy-penguins-banner.jpg?1730778702","floor_native":4.2,"total_supply":8888,"market_cap_usd":59415139,"unique_holders":5178,"volume_24h_usd":255968,"market_cap_rank":4,"native_currency":"ethereum","contract_address":"0xBd3531dA5CF5857e7CfAA92426877b022e612cf8","market_cap_native":37321,"volume_24h_native":160.78,"floor_change_1y_pct":-71.85955050616847,"floor_change_7d_pct":-21.743654930146064,"floor_change_24h_pct":-7.93268985160009,"floor_change_30d_pct":-48.07772553067951,"volume_change_24h_pct":41.73894572813876,"native_currency_symbol":"ETH","market_cap_change_24h_pct":-7.932689851600114,"unique_holders_change_24h_pct":-0.0579}},"exampleRequest":{"chain":"ethereum","collection":"pudgy-penguins","recent_sales_limit":5,"include_recent_sales":true},"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_3wQPO1w_gD-wOubVCMOvU","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns NFT collection floor price, top bid, volume stats, rank, and recent sales across Ethereum, Base, Arbitrum, Optimism, and Polygon using Reservoir.","exampleAgentPrompt":"What's the current floor price, top bid, and 7-day volume for the Pudgy Penguins collection on Ethereum, and can you also show me the most recent sales?","exampleUseCases":null,"resultDescription":"Returns floor price in ETH/USD, top bid, 24h/7d/30d volume with percentage changes, collection rank, and a list of recent sales including token IDs, sale prices, and timestamps — sourced from Reservoir across supported EVM chains.","failureModes":["Unknown or invalid collection address returns empty result or 404","Unsupported chain returns an error indicating which networks are valid","Reservoir API downtime may cause timeout or 503","Malformed contract address returns validation error","Collection with no recent sales returns empty sales array but may still return floor data"],"whenToPreferThis":"Use this endpoint when you need comprehensive NFT collection market data — floor price, bid depth, multi-period volume, and recent sale history — across major EVM chains (Ethereum, Base, Arbitrum, Optimism, Polygon) in a single call, powered by Reservoir's aggregated marketplace data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:48:49.969Z","isFirstParty":false}