{"uid":"cap_tAVBdBsJpEVYyN8S_tp6n","slug":"phantom-api-optimism-nft-metadata-5efb6f3d","name":"Phantom API – Optimism NFT Metadata","description":"Lightning-fast access to blockchain data, smart contract insights, and Web3 infrastructure across 57+ networks. Pay-per-call via x402.","url":"https://phantom-api-omega.vercel.app/api/optimism/nft/metadata","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tokenId":{"type":"string"},"contractAddress":{"type":"string"}}},"responseSchema":null,"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_UyveuBYRZtwSMFbms_ufS","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 on-chain NFT metadata (name, description, image, attributes) for a given contract and token ID on the Optimism network.","exampleAgentPrompt":"Can you pull up the metadata for token ID 1234 from the Optimism NFT contract at 0x4200000000000000000000000000000000000042 — I want to see its name, image, and traits?","exampleUseCases":[{"title":"NFT portfolio trait lookup","prompt":"I want to see all the attributes and the image for token ID 88 from the Optimism NFT contract 0x3B3ee1931Dc30C1957379FAc9aba94D1C48a5405 — can you fetch that for me?"},{"title":"NFT marketplace listing enrichment","prompt":"For the NFT I'm about to list — contract 0xDeadBeef000000000000000000000000DeAdBeEf, token ID 7 on Optimism — can you grab its metadata so I can auto-fill the title, description, and image?"},{"title":"Verify NFT authenticity before purchase","prompt":"Before I buy this Optimism NFT, can you check the metadata for token ID 301 at contract address 0x1234567890abcdef1234567890abcdef12345678 and tell me what traits it actually has on-chain?"}],"resultDescription":"Returns the on-chain NFT metadata for the specified token on Optimism, typically including token name, description, image URI, and an array of trait/attribute key-value pairs as defined in the token's contract metadata standard (ERC-721/ERC-1155).","failureModes":["Invalid or non-existent contract address returns an error or empty response","Token ID not found in the contract returns a null or error result","Contract does not implement standard metadata URI methods — metadata unavailable","Optimism RPC node temporarily unavailable — request times out","Malformed contractAddress or tokenId inputs cause a 400-level error","IPFS or off-chain metadata URI unreachable — image/attributes may be missing"],"whenToPreferThis":"Choose this endpoint when you need fast, pay-per-call NFT metadata retrieval specifically on the Optimism (OP Mainnet) network. It is ideal for agents that need to enrich NFT data on demand without managing RPC infrastructure. Prefer this over generic blockchain RPC calls when you need a simple POST interface and don't want to handle raw contract ABI decoding. Best suited for single-token lookups rather than bulk indexing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:54:43.248Z","isFirstParty":false}