{"uid":"cap_LTqH0hFEYynWXChtmFWBs","slug":"chainray-nft-token-metadata-lookup-fcf9e2f3","name":"ChainRay NFT Token Metadata Lookup","description":"The most complete blockchain data and intelligence service for AI agents. 93 endpoints across 46 chains, from gas fees to DeFi analytics, with real-time streams, intent routing, and verifiable proofs. Pay-per-request via x402.","url":"https://chainray.online/nft/%7Bcontract%7D/%7BtokenId%7D","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"pathParams":{"type":"object"},"queryParams":{"type":"object","required":["contract"],"properties":{"chain":{"type":"string","description":"Blockchain network"},"contract":{"type":"string","description":"NFT contract address"}}}},"additionalProperties":false}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"chain":"ethereum","tokenId":"1","contract":"0x1234567890123456789012345678901234567890"}}},"response":{"chain":"ethereum","owner":"unknown (ERC1155 or error)","_proof":{"chain":"ethereum","dataHash":"923fa322e9a1cf3a4ba0bc76843b38042b7ae28d02d42c66531615db783a0019","blockHash":"0xe63db22ab7b7414f07841042cecdab522fa86a1b8171ab458f5f0376e9d5178f","chainName":"Ethereum","blockNumber":25342560,"proofVersion":"3.0","blockTimestamp":1781762951,"proofTimestamp":1781762964194},"tokenId":"1","contract":"0x1234567890123456789012345678901234567890","metadata":null,"standard":"unknown","tokenURI":null,"analyzedAt":1781762964194,"collection":"Unknown"}},"exampleRequest":{"chain":"ethereum","tokenId":"1","contract":"0x1234567890123456789012345678901234567890"},"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0x5Co1fJcdloY41AnQHd_","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches on-chain metadata and details for a specific NFT token by contract address and token ID on a given blockchain network","exampleAgentPrompt":"Can you look up the metadata and attributes for NFT token ID 1234 from contract address 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum?","exampleUseCases":null,"resultDescription":"Returns on-chain metadata for the specified NFT token, including traits/attributes, ownership info, image URI, collection details, and other token-level properties for the given contract and token ID on the specified chain.","failureModes":["Invalid or non-existent contract address returns error","Token ID not found or out of range for the collection","Unsupported blockchain network specified","Payment not fulfilled results in 402 response","Contract address is not an NFT contract","Network congestion may delay response"],"whenToPreferThis":"Use this endpoint when you need on-chain NFT token-level metadata for a specific token ID and contract address. Prefer this over general blockchain explorers when you need structured, agent-ready JSON output across 46 supported chains with pay-per-request pricing and no subscription required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:24.632Z","isFirstParty":false}