{"uid":"cap_YEXKtrWwSLBxyyovwpnAR","slug":"phantom-api-soneium-nft-metadata-lookup-29249cc8","name":"Phantom API — Soneium NFT Metadata Lookup","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/soneium/nft/metadata?utm_source=zero.xyz","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_6prkKw3kNRZLQUMt6SpXH","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 for a given token and contract address on the Soneium blockchain network.","exampleAgentPrompt":"Can you pull up the metadata for token ID 42 from the Soneium NFT contract at address 0xAbCd1234...5678? I want to see the name, image, and any traits associated with it.","exampleUseCases":[{"title":"Display NFT details in a gallery app","prompt":"Fetch the metadata for token ID 101 from the Soneium contract 0x1234abcd...5678 — I need the image URL, name, and trait attributes to display it in my NFT gallery."},{"title":"Verify NFT ownership traits before a trade","prompt":"Before I agree to this trade, can you pull the on-chain metadata for token 7 from Soneium contract 0xdeadbeef...cafe so I can confirm its rarity traits and description?"},{"title":"Aggregate NFT data for a portfolio dashboard","prompt":"I'm building a portfolio tracker — can you retrieve the metadata for token ID 200 on Soneium at contract address 0xfeedface...1234, including the image and any listed attributes?"}],"resultDescription":"Returns structured NFT metadata for the specified token on the Soneium network, typically including the token name, description, image URL, and an array of trait/attribute objects (trait_type and value pairs), as well as any other standard ERC-721/1155 metadata fields stored on-chain or in linked JSON.","failureModes":["Invalid or non-existent contract address returns an error or empty response","Token ID does not exist on the contract — returns not found or null metadata","Soneium RPC node unavailability causes timeout or 503 error","Malformed input (missing contractAddress or tokenId) returns a 400 bad request","Metadata hosted off-chain (IPFS/Arweave) may be unreachable, resulting in incomplete metadata","Payment failure via x402 protocol blocks the request"],"whenToPreferThis":"Use this endpoint when you specifically need NFT metadata from the Soneium network and want pay-per-call pricing via x402 (USDC) without managing API keys or subscriptions. Prefer this over general-purpose NFT APIs when Soneium chain coverage is required, or when you need lightweight per-call billing for sporadic lookups rather than bulk indexing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-20T18:47:01.641Z","isFirstParty":false,"canonicalSlug":"phantom-api-soneium-nft-metadata-lookup-29249cc8"}