{"uid":"cap_Pczm5XdoFH9oSjl-gVH2C","slug":"nft-metadata-lookup-bd0cf8a7","name":"NFT Metadata Lookup","description":"Fetch NFT metadata from contract and token ID","url":"https://nft-metadata.api.klymax402.com/api/metadata","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"chain":{"type":"string","description":"Blockchain: 'ethereum' or 'base' (default: ethereum)"},"tokenId":{"type":"string","description":"Token ID within the contract"},"contract":{"type":"string","description":"NFT contract address (e.g. 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.008","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.008/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.008","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_U4tWbhKqM4JAe7Nj3-iW7","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.008","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain NFT metadata (name, description, image, attributes, etc.) for a given contract address and token ID on Ethereum or Base","exampleAgentPrompt":"Can you fetch the metadata for Bored Ape Yacht Club token ID 1234 — the contract is 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":null,"resultDescription":"Returns NFT metadata for the specified token, typically including the token name, description, image URL, animation URL (if any), and a list of trait/attribute key-value pairs as defined by the contract's token URI.","failureModes":["Invalid or non-existent contract address returns an error or empty response","Token ID does not exist within the contract (unminted or burned token)","Unsupported chain value (only 'ethereum' and 'base' are accepted)","Contract is not ERC-721 or ERC-1155 compliant and metadata cannot be resolved","Off-chain metadata URI is unreachable or returns malformed JSON","Payment failure results in 402 response before metadata is returned"],"whenToPreferThis":"Use this endpoint when you need to retrieve NFT metadata directly by contract address and token ID on Ethereum or Base, without scraping a marketplace UI. Prefer this over general blockchain explorers when you need structured metadata (traits, image, description) in a programmatic, agent-friendly format for a single token lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:32:57.256Z","isFirstParty":false}