{"uid":"cap_4aa4cl4gg0WUMTCgVj5XA","slug":"polygon-pos-nft-metadata-lookup-b4538943","name":"Polygon PoS NFT Metadata Lookup","description":"Pay-per-call data for AI agents, paid in USDC on Base with x402: token risk checks (rug check) on Base, Ethereum, Arbitrum, Optimism, Polygon and Solana, onchain reads (balances, transactions, gas, contracts, NFTs, whale trades, new pools, ENS and Basenames), ECB exchange rates, and Canadian sales tax and business days.","url":"https://ca-tax-api-mainnet.lxtap.workers.dev/polygon/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 Polygon PoS"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"polygon","owner":"0x7241DDDec3A6aF367882eAF9651b87E1C7549Dff","tokenId":"5","contract":"0xDb46d1Dc155634FbC732f92E853b10B288AD5a1d","imageUrl":"data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNzUiIGhlaWdodD0iMjc1IiBmaWxsPSJub25lIj48Zz48cGF0aCBmaWxsPSJ1cmwoI3llbGxvdykiIGQ9Ik0wIDBoMjc1djQxNUgweiIvPjwvZz… (240 chars, truncated in this example)","metadata":{"name":"Profile #5","image":"data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIyNzUiIGhlaWdodD0iMjc1IiBmaWxsPSJub25lIj48Zz48cGF0aCBmaWxsPSJ1cmwoI3llbGxvdykiIGQ9Ik0wIDBoMjc1djQxNUgweiIvPjwvZz… (240 chars, truncated in this example)","attributes":[{"value":"5","trait_type":"ID","display_type":"number"},{"value":"0x05","trait_type":"HEX ID"},{"value":"1","trait_type":"DIGITS"},{"value":"1652809016","trait_type":"MINTED AT","display_type":"date"},{"value":"gold","trait_type":"Background"}],"description":"Lens Protocol - Profile #5"},"standard":"ERC-721","tokenUri":"data:application/json;base64,eyJuYW1lIjo…","collection":"Lens Protocol Profiles","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_xFXyLCI1udIzjV-Tq2my0","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 NFT on Polygon PoS, including collection name, owner, token URI, and decoded metadata JSON with a browser-loadable image URL.","exampleAgentPrompt":"Can you look up the metadata for token ID 4821 of the NFT contract 0x2953399124F0cBB46d2CbACD364f62ff6ab7B1f2 on Polygon PoS — I want the collection name, current owner, and the actual image URL?","exampleUseCases":[{"title":"Verify NFT ownership before transfer","prompt":"Before I send this NFT, can you confirm who currently owns token ID 12 of the contract 0xA1B2c3d4e5f6a7B8c9D0e1f2A3b4C5d6E7f8A9b0 on Polygon PoS?"},{"title":"Display NFT gallery with images","prompt":"I'm building a gallery — fetch me the image URL and traits for token ID 7 of the Polygon NFT contract 0x2953399124F0cBB46d2CbACD364f62ff6ab7B1f2 so I can display it on the page."},{"title":"Research NFT collection details","prompt":"What's the collection name and metadata for token ID 999 of contract 0x5C69bEe701ef814a2B6a3EDD4B1652CB9cc5aA6f on Polygon PoS? I want to understand what this NFT project is about."}],"resultDescription":"Returns a JSON object containing the collection name, current owner address (for ERC-721 tokens), the token URI, the full decoded metadata JSON (name, description, attributes/traits), and a browser-loadable image URL resolved from IPFS, Arweave, HTTPS, or an inline data URI.","failureModes":["Invalid contract address format (not a 0x-prefixed 40-character hex) returns a validation error","Token ID out of range or non-existent token returns a not-found or revert error","IPFS or Arweave gateway timeout causes metadata resolution failure","Contract does not implement ERC-721 or ERC-1155 returns an interface mismatch error","Broken or unreachable token URI results in incomplete metadata with a null image URL","Payment failure (x402 protocol) prevents the call from being processed"],"whenToPreferThis":"Choose this endpoint when you need complete, decoded NFT metadata — including a ready-to-use image URL — for a specific token on Polygon PoS. It is especially useful when the token URI points to IPFS, Arweave, or an inline data URI that requires resolution and decoding, saving you the step of fetching and parsing the metadata yourself. Prefer this over generic blockchain RPC calls when you want a single response containing collection name, owner, and rendered image URL in one shot.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-23T12:44:40.256Z","isFirstParty":false,"canonicalSlug":"polygon-pos-nft-metadata-lookup-b4538943"}