{"uid":"cap_G1PHXERT18xIEaxfl7nc_","slug":"padelmaps-org-nft-metadata-11920201","name":"padelmaps-org/nft-metadata","description":"Get NFT metadata, ownership history, and collection info","url":"https://padelmaps.org/api/x402-crypto/nft-metadata?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","bodyType","body"],"properties":{"body":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["contract_address","token_id"],"properties":{"chain":{"type":"string","description":"Blockchain (default: ethereum)"},"token_id":{"type":"string","description":"Token ID of the NFT (numeric string)"},"contract_address":{"type":"string","description":"NFT contract address (0x + 40 hex chars)"}}},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"data":{"type":"object","properties":{"chain":{"type":"string"},"owner":{"type":"string","description":"Current owner address"},"metadata":{"type":"object","description":"NFT name, description, image URL, attributes"},"token_id":{"type":"string"},"collection":{"type":"object","description":"Collection name, symbol, total supply"},"explorer_url":{"type":"string","description":"Link to view NFT on block explorer"},"contract_address":{"type":"string"},"transfer_history":{"type":"array","description":"Recent transfer history"}}},"success":{"type":"boolean"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_NWjgXJtlFtuI_Ugi3FkvS","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves NFT metadata, current ownership, transfer history, and collection info for a given contract address and token ID on a specified blockchain","exampleAgentPrompt":"Can you pull up the metadata and current owner for NFT token ID 5678 on the contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":[{"title":"Verify NFT ownership before trade","prompt":"I need to check who currently owns token ID 42 on the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum — show me the owner address and recent transfer history."},{"title":"Display NFT art and attributes","prompt":"Fetch the metadata for token ID 1001 on contract 0x60E4d786628Fea6478F785A6d7e704777c86a7c6 on Ethereum — I need the image URL, name, description, and all the trait attributes to display in my gallery app."},{"title":"Research NFT collection supply","prompt":"Look up collection info for token ID 7777 on the Azuki contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544 on Ethereum — I want to know the collection name, symbol, and total supply."}],"resultDescription":"Returns a JSON object with success status and a data payload containing: NFT metadata (name, description, image URL, attributes), current owner address, collection details (name, symbol, total supply), full transfer history array, blockchain identifier, contract address, token ID, and a block explorer URL linking directly to the NFT.","failureModes":["Invalid contract address format returns an error (must be 0x + 40 hex chars)","Non-existent token ID returns not-found error","Unsupported blockchain chain value returns error","NFT with no on-chain metadata may return empty metadata fields","Rate limiting or payment failure returns 402 or 429 error","Network congestion may cause slow or timeout responses"],"whenToPreferThis":"Use this endpoint when you need comprehensive NFT data in a single call — combining metadata, ownership, transfer history, and collection info — without having to query multiple blockchain RPC endpoints or indexers directly. Ideal for agents building NFT displays, verifying provenance, or auditing ownership chains on Ethereum or other supported EVM chains.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T06:31:41.984Z","isFirstParty":false,"canonicalSlug":"padelmaps-org-nft-metadata-11920201"}