{"uid":"cap_pV2o2LMfVAcbk10fmTlQB","slug":"polygon-pos-nft-onchain-data-ebc77591","name":"Polygon PoS NFT Onchain Data","description":"Metadata for an ERC-721 or ERC-1155 token on Polygon PoS: 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/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_1iHjYJ6gptLp0E73OprML","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 metadata for an ERC-721 or ERC-1155 token on Polygon PoS, including collection name, current owner, token URI, decoded metadata JSON, and a browser-loadable image URL.","exampleAgentPrompt":"Look up the on-chain metadata for token ID 5 on the Polygon NFT contract 0xDb46d1Dc155634FbC732f92E853b10B288AD5a1d — I want the collection name, current owner, attributes, and a loadable image URL.","exampleUseCases":[{"title":"Verify NFT ownership before gating access","prompt":"Check who currently owns token ID 42 on the Polygon contract 0xDb46d1Dc155634FbC732f92E853b10B288AD5a1d — I need to confirm ownership before granting this user access to my platform."},{"title":"Display NFT gallery card with traits","prompt":"Pull the full metadata and image for token ID 1337 at Polygon contract 0x2953399124F0cBB46d2CbACD8A89cF0599974963 so I can render it in my NFT gallery, including its trait attributes."},{"title":"Audit Lens Protocol Profile NFT details","prompt":"Fetch the on-chain info for Lens Protocol Profile token ID 100 on Polygon — I want the collection name, token URI, decoded metadata, and the background trait to add to my spreadsheet."}],"resultDescription":"Returns a JSON object with: chain identifier ('polygon'), contract address, token ID, NFT standard (ERC-721 or ERC-1155), collection name, current owner address (ERC-721), token URI, fetchedFrom source (IPFS/Arweave/HTTPS/inline data URI), a browser-loadable imageUrl, and the full decoded metadata object including name, description, image, and attributes array.","failureModes":["Invalid contract address format returns a validation error","Non-existent token ID returns an error or empty response","IPFS/Arweave metadata unreachable causes fetch failure","Token on a different chain than Polygon PoS will not be found","Malformed or non-standard token URI may result in incomplete metadata","Rate limiting or payment failure (402) if USDC payment not provided"],"whenToPreferThis":"Use this endpoint when you need comprehensive NFT metadata for a specific token on Polygon PoS, including decoded metadata from IPFS, Arweave, HTTPS, or inline data URIs, along with a ready-to-display image URL. Prefer this over generic blockchain RPCs when you need the metadata JSON resolved and decoded automatically without handling IPFS gateways yourself. Best for ERC-721 or ERC-1155 tokens specifically on the Polygon PoS network.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T12:38:00.621Z","isFirstParty":false,"canonicalSlug":"polygon-pos-nft-onchain-data-ebc77591"}