{"uid":"cap_mv01TRT6LpMvuaHDQygUw","slug":"phantom-api-nft-sales-by-contract-925cf46e","name":"Phantom API — NFT Sales by Contract","description":"Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.","url":"https://phantom-api-omega.vercel.app/api/bob/nft/sales?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"number"},"order":{"enum":["asc","desc"],"type":"string"},"toBlock":{"type":"number"},"fromBlock":{"type":"number"},"contractAddress":{"type":"string"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.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_6ABEfX94sxwa9QR2yFIOI","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain NFT sales events for a given smart contract address across a specified block range, with ordering and pagination controls.","exampleAgentPrompt":"Pull the last 50 NFT sales for contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13d, going from block 18000000 to 19000000, ordered from newest to oldest.","exampleUseCases":[{"title":"Track NFT collection sales history","prompt":"Get me the most recent 100 NFT sales for the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13d, ordered from newest to oldest, between blocks 19000000 and 19500000."},{"title":"Monitor floor price drops during a block window","prompt":"Fetch the first 25 NFT sales for contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 between blocks 18500000 and 18600000 in ascending order so I can track early activity."},{"title":"Analyze NFT trading volume for a DeFi dashboard","prompt":"Pull all available NFT sales for contract 0xd8a4c520d7c5b6d45c0e2a10b6b5b8f1c0e2a5d between blocks 17000000 and 18000000, ordered ascending, with a limit of 200, so I can calculate total volume traded."}],"resultDescription":"Returns a list of on-chain NFT sale events for the specified contract, filtered by block range and ordered as requested. Each record typically includes transaction hash, block number, token ID, sale price, buyer and seller addresses, and timestamp-equivalent block data.","failureModes":["Invalid or non-existent contract address returns empty results or error","Block range too wide may result in timeouts or truncated results","fromBlock greater than toBlock causes invalid range error","Missing contractAddress field may result in a 400 bad request","Payment failure via x402 protocol blocks the call entirely","Rate limits or quota exhaustion return 402 or 429 errors"],"whenToPreferThis":"Use this endpoint when you need historical or recent NFT sale events scoped to a specific smart contract and block range on-chain. It is ideal for analytics pipelines, collection tracking dashboards, or agent workflows that need raw NFT sales data with block-level precision. Prefer this over general-purpose blockchain explorers when you need programmatic, pay-per-call access without API key management.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T18:46:36.570Z","isFirstParty":false,"canonicalSlug":"phantom-api-nft-sales-by-contract-925cf46e"}