{"uid":"cap_xFTtSJZ_4SpL3J2GMJZYS","slug":"op-mainnet-nft-metadata-lookup-7aeba6ba","name":"OP Mainnet NFT Metadata Lookup","description":"Metadata for an ERC-721 or ERC-1155 token on OP Mainnet: collection name, current owner (ERC-721), token URI, and the metadata JSON fetched and decoded from IPFS, Arweave, HTTPS or an inline data URI, with a browser-loadable image URL.","url":"https://onchaincheck.dev/optimism/nft?utm_source=zero.xyz","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"},"queryParams":{"type":"object","required":["contract","tokenId"],"properties":{"tokenId":{"type":"string","pattern":"^\\d{1,78}$","description":"Token id as a decimal string"},"contract":{"type":"string","pattern":"^0x[0-9a-fA-F]{40}$","description":"NFT collection contract on OP Mainnet"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"optimism","owner":"0xc2EEdF3bC7F93366c00c6074DF0e6F122fa2445c","tokenId":"1043","contract":"0x4857DB576eE0e45F10525eC59527BfD10beeC60b","imageUrl":"data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDAwIiBoZWlnaHQ9IjQwMCIgdmlld0JveD0iMCAwIDQwMCA0MDAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLz… (240 chars, truncated in this example)","metadata":{"name":"CL - USDC/ETH - 2397.1<>2421.2","image":"data:image/svg+xml;base64,PHN2ZyB3aWR0aD0iNDAwIiBoZWlnaHQ9IjQwMCIgdmlld0JveD0iMCAwIDQwMCA0MDAiIGZpbGw9Im5vbmUiIHhtbG5zPSJodHRwOi8vd3d3LnczLm9yZy8yMDAwL3N2ZyIgeG1sbnM6eGxpbms9Imh0dHA6Ly93d3cudzMub3JnLz… (240 chars, truncated in this example)","description":"This NFT represents a liquidity position in a Velodrome Finance USDC-ETH pool. The owner of this NFT can modify or redeem the position.\n\nPool Address: 0xca231d91ec00385a54e541f504617d2197f9b7c3\nUSDC A… (240 chars, truncated in this example)"},"standard":"ERC-721","tokenUri":"data:application/json;base64,eyJuYW1lIjo…","collection":"Slipstream V3 Deposit","fetchedFrom":"inline data URI"}},"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_NOVOqVb1gDu5jUUNirTRR","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 full metadata for an ERC-721 or ERC-1155 token on OP Mainnet, including collection name, owner, token URI, and decoded metadata with a browser-loadable image URL.","exampleAgentPrompt":"Can you pull up the full metadata for NFT token ID 1043 from contract 0x4857DB576eE0e45F10525eC59527BfD10beeC60b on OP Mainnet — I want to know the collection name, current owner, and see the image?","exampleUseCases":[{"title":"NFT portfolio viewer for OP Mainnet","prompt":"I hold token ID 42 from contract 0xAbC123...on Optimism — can you fetch its name, image, and description so I can display it in my portfolio?"},{"title":"Verify NFT ownership before trade","prompt":"Before I buy this Optimism NFT, can you confirm who currently owns token 7 from collection 0x4857DB576eE0e45F10525eC59527BfD10beeC60b and show me what the token actually looks like?"},{"title":"Inspect DeFi position NFT details","prompt":"I have a Velodrome liquidity position NFT on Optimism — token ID 1043 at 0x4857DB576eE0e45F10525eC59527BfD10beeC60b — can you get me the full metadata including the pool details from the description?"}],"resultDescription":"Returns a JSON object with the chain (optimism), contract address, token ID, NFT standard (ERC-721 or ERC-1155), collection name, current owner address (for ERC-721), raw token URI, a browser-loadable imageUrl, and a fully decoded metadata object (name, description, image, attributes) resolved from IPFS, Arweave, HTTPS, or inline data URIs, along with the source it was fetched from.","failureModes":["Invalid contract address format returns a validation error","Token ID out of range or non-existent token returns a not-found error","IPFS or Arweave gateway timeout if metadata is hosted on a slow or unavailable node","Contract exists but does not implement ERC-721 or ERC-1155 returns a standard-detection error","Token URI points to an unreachable or malformed metadata endpoint"],"whenToPreferThis":"Choose this endpoint when you need complete, decoded NFT metadata for a specific token on OP Mainnet (Optimism), including image resolution from IPFS, Arweave, or inline data URIs. Prefer this over generic blockchain RPC calls when you need a human-readable, browser-ready result without writing custom decoding logic. Use this instead of the Base or Polygon PoS equivalents when the NFT contract is deployed specifically on Optimism.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:39:05.000Z","isFirstParty":false,"canonicalSlug":"op-mainnet-nft-metadata-lookup-7aeba6ba"}