{"uid":"cap_MXBvTZxfQDyXSoK6z0jRU","slug":"saylor-innovations-data-desk-nft-metadata-resolver-a8cc8048","name":"Saylor Innovations Data Desk – NFT Metadata Resolver","description":"NFT metadata by token id on 16 EVM chains: token URI from the contract, then name, image, description and traits resolved from IPFS, Arweave or inline data.","url":"https://saylorinnovations.com/api/chain/nft-metadata?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":["chain","collection","token_id"],"properties":{"chain":{"type":"string","description":"chain name (ethereum, base, arbitrum, optimism, polygon, bsc, avalanche, gnosis, linea, scroll, mantle, blast, sonic, celo, berachain, unichain) or chain id"},"token_id":{"type":"string","description":"the token id (decimal or 0x hex)"},"collection":{"type":"string","description":"the ERC-721 or ERC-1155 contract"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["chain","chain_id","collection","token_id","token_uri","uri_scheme","metadata_fetched","note","source"],"properties":{"name":{"type":["string","null"],"description":"name field of the metadata document"},"note":{"type":"string","description":"plain-language reading of the result"},"chain":{"type":"string","description":"the chain name that was queried"},"image":{"type":["string","null"],"description":"image URL with ipfs links rewritten to a gateway"},"source":{"type":"string","description":"where the data was read from"},"chain_id":{"type":"number","description":"EIP-155 chain id of that network"},"standard":{"type":"string","description":"ERC-721 or ERC-1155"},"token_id":{"type":"string","description":"the token id queried, decimal"},"token_uri":{"type":"string","description":"URI returned by the contract"},"attributes":{"type":["array","null"],"description":"traits as trait_type and value pairs, up to 50"},"collection":{"type":"string","description":"the NFT contract"},"fetch_note":{"type":["string","null"],"description":"why the document was not fetched, if it was not"},"uri_scheme":{"type":"string","description":"scheme of that URI (ipfs, ar, data, https)"},"description":{"type":["string","null"],"description":"description field, truncated to 1,000 characters"},"external_url":{"type":["string","null"],"description":"external page for the token"},"animation_url":{"type":["string","null"],"description":"animation or media URL"},"collection_name":{"type":["string","null"],"description":"contract name()"},"metadata_fetched":{"type":"boolean","description":"true when the metadata document was read"},"collection_symbol":{"type":["string","null"],"description":"contract symbol()"}}}}}}},"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_QjetKexe9kcky_08CKSBJ","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 NFT metadata (name, image, description, traits) for any token ID on 16 EVM chains by resolving token URI from the contract, then fetching from IPFS, Arweave, or inline data.","exampleAgentPrompt":"What's the name, image, and traits for token ID 1234 on the Bored Ape Yacht Club contract (0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D) on Ethereum?","exampleUseCases":[{"title":"NFT trait lookup for rarity analysis","prompt":"Can you pull the traits for token ID 7495 on the Azuki contract 0xED5AF388653567Af2F388E6224dC7C4b3241C544 on Ethereum? I want to see all its attributes."},{"title":"Cross-chain NFT image retrieval","prompt":"Fetch the image and description for token ID 42 from the contract 0x3bf2922f4520a8BA0c2eFC3D2a1539678DaD5e9D on Base — I need to display it in my app."},{"title":"ERC-1155 metadata resolution on Polygon","prompt":"Look up the metadata for token ID 3 on the ERC-1155 contract 0x2953399124f0cbb46d2cbacd8a89cf0599974963 on Polygon, including any traits or properties it has."}],"resultDescription":"A JSON object containing the chain name and chain ID, contract address, token ID, token URI returned by the contract, the URI scheme, whether metadata was fetched, the NFT name, image URL (with IPFS links rewritten to a gateway), description, up to 50 trait/attribute pairs, the ERC standard (ERC-721 or ERC-1155), the data source, and a plain-language note explaining the result. Includes a fetch_note field when metadata could not be retrieved.","failureModes":["Contract not found on specified chain — returns error or empty token URI","Token ID does not exist — contract reverts or returns empty URI","IPFS or Arweave gateway timeout — metadata_fetched false with fetch_note explaining failure","Invalid chain name or chain ID — returns error indicating unsupported chain","Inline data URI malformed — metadata parsing fails with fetch_note","Rate limiting or payment failure at $0.01 USDC per call — HTTP 402 response"],"whenToPreferThis":"Use this endpoint when you need to resolve full NFT metadata (name, image, traits) for a specific token ID on any of 16 supported EVM chains, especially when the token URI points to IPFS or Arweave storage that requires gateway resolution. Prefer this over general blockchain RPC calls when you want structured, ready-to-use metadata without handling URI resolution, IPFS pinning, or Arweave fetching yourself. Covers ERC-721 and ERC-1155 standards.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T12:33:00.572Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-nft-metadata-resolver-a8cc8048"}