{"uid":"cap_ZUtFIfTFpJu7qa7rctcHS","slug":"synapse-api-polygon-nft-metadata-lookup-8dd55c38","name":"Synapse API — Polygon NFT Metadata Lookup","description":"High-speed API suite for AI processing, web scraping, and smart data utilities across 57+ blockchain networks. Pay-per-call via x402.","url":"https://synapse-api-brown.vercel.app/api/polygon/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_D00BflzbIL736XRURbMbd","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 contract address and token ID on the Polygon blockchain network","exampleAgentPrompt":"Can you pull up the metadata for token ID 4521 from the Polygon NFT contract at 0x2953399124F0cBB46d2CbACD364...? I want to see its name, image, and traits.","exampleUseCases":[{"title":"NFT trait verification for marketplace listing","prompt":"I'm listing an NFT on OpenSea — can you fetch the metadata for token ID 1337 on the Polygon contract 0xABCD1234... so I can confirm the traits and image look correct before I publish?"},{"title":"NFT portfolio display in a wallet app","prompt":"Pull the metadata for Polygon NFT token ID 88 from contract 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D so I can show the image and attributes in my portfolio view."},{"title":"Rarity and attribute analysis for a collector","prompt":"What are the traits and attributes for token ID 500 on the Polygon contract 0x3a3048Af575d73B3A56Bb7Ba96a992B5e4F1dAb1? I'm trying to compare its rarity against other tokens in the collection."}],"resultDescription":"Returns NFT metadata for the specified Polygon token, typically including the token name, description, image URL, and an array of attributes/traits as defined by the NFT contract's metadata standard (ERC-721 or ERC-1155).","failureModes":["Invalid or non-existent contract address returns an error or empty response","Token ID not found within the contract returns a not-found or null metadata response","Contract does not implement standard metadata URI returns incomplete or missing data","Polygon RPC node downtime causes lookup failure","Malformed contractAddress or tokenId input triggers a validation error","Payment failure via x402 prevents the call from completing"],"whenToPreferThis":"Choose this endpoint when you need to retrieve NFT metadata specifically on the Polygon (MATIC) network by contract address and token ID. It is pay-per-call via x402, making it suitable for on-demand agent-driven lookups without a subscription. Prefer this over general blockchain explorers when you need structured metadata output in an agent-callable API format. If you need metadata on other chains (Ethereum, Solana, etc.), look for sibling endpoints in the same Synapse API suite.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T00:51:58.854Z","isFirstParty":false,"canonicalSlug":"synapse-api-polygon-nft-metadata-lookup-8dd55c38"}