{"uid":"cap_dPMACwBxgAWiqEP9NEuBm","slug":"basenft-oracle-x402-6f0e5b0d","name":"BaseNFT Oracle x402","description":"Real-Time Base NFT Collection, Floor Price & Ownership Verification Oracle on Base Mainnet.","url":"https://basenft-x402.vercel.app/v1/collection","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","title":"CollectionRequest","properties":{"collection":{"type":"string","title":"Collection","default":"basenames","maxLength":64,"minLength":1}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"const":"json"},"example":{"type":"object","required":["success","collection","source","market_data_available"],"properties":{"source":{"type":"string"},"network":{"const":"base-mainnet"},"success":{"type":"boolean"},"collection":{"type":"object","required":["address","identity_verified","metadata_source"],"properties":{"name":{"type":["string","null"]},"slug":{"type":["string","null"]},"symbol":{"type":["string","null"]},"address":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$"},"metadata_source":{"enum":["local_registry","user_supplied_address"]},"identity_verified":{"const":false}}},"limitations":{"type":"array","items":{"type":"string"}},"contract_address":{"type":"string"},"observation_type":{"const":"registry_metadata"},"market_data_available":{"const":false}}}}}}},"responseSchema":{"type":"object","properties":{"address":{"type":"string"},"collection":{"type":"string"},"total_supply":{"type":"integer"},"floor_price_eth":{"type":"number"},"floor_price_usd":{"type":"number"}}},"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_plqsuUu42iYyA2F_omkaE","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":"Fetches real-time NFT collection metadata, floor price, and supply data for Base Mainnet collections by slug or address","exampleAgentPrompt":"What's the current floor price and total supply for the Basenames NFT collection on Base mainnet?","exampleUseCases":[{"title":"NFT floor price alert system","prompt":"Check the floor price of the Basenames collection on Base mainnet and let me know if it's dropped below 0.01 ETH."},{"title":"Portfolio valuation for Base NFTs","prompt":"I hold some Base NFTs — can you look up the floor price in USD for the 'basenames' collection on Base mainnet so I can estimate what my holdings are worth?"},{"title":"NFT collection research before purchase","prompt":"Before I buy into a Base NFT project, can you pull up the contract address, total supply, and current ETH floor price for the 'basenames' collection?"}],"resultDescription":"Returns a JSON object containing the NFT collection's contract address, canonical name, total token supply, floor price denominated in ETH, and floor price converted to USD for the queried Base Mainnet collection.","failureModes":["Unknown collection slug returns registry metadata only with market_data_available=false","Invalid or unrecognized contract address returns identity_verified=false","Network errors or Vercel cold starts may cause latency or timeouts","Collections not in the local registry return limited metadata without verified identity","Payment of $0.01 USDC required per call via x402 protocol; unpaid requests are rejected"],"whenToPreferThis":"Choose this endpoint when you need real-time NFT floor price and supply data specifically for collections deployed on Base Mainnet (Ethereum L2). It is ideal for agents doing NFT portfolio valuation, market monitoring, or pre-purchase research on Base. Prefer this over Ethereum mainnet NFT oracles when the target collection is Base-native, and over generic blockchain explorers when you need structured market data (floor price in ETH and USD) rather than raw on-chain data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-19T06:41:11.174Z","isFirstParty":false}