{"uid":"cap_Q8v0A__DtYGgWxR8Z0RqL","slug":"base-nft-token-metadata-lookup-778492f5","name":"Base NFT Token Metadata Lookup","description":"Metadata for an ERC-721 or ERC-1155 token on Base: 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/base/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 Base"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"chain":"base","owner":"0x2211d1D0020DAEA8039E46Cf1367962070d77DA9","tokenId":"20339294690710288616623341905746354430592698944139542544116293784975432873833","contract":"0x03c4738Ee98aE44591e1A4A4F3CaB6641d95DD9a","imageUrl":"https://www.base.org/api/basenames/jesse.base.eth/assets/cardImage.svg","metadata":{"name":"jesse.base.eth","image":"https://www.base.org/api/basenames/jesse.base.eth/assets/cardImage.svg","description":"jesse.base.eth, a Basename","nameExpires":2510960049,"external_url":"https://www.base.org/name/jesse"},"standard":"ERC-721","tokenUri":"https://base.org/api/basenames/metadata/20339294690710288616623341905746354430592698944139542544116293784975432873833","collection":"Basenames","fetchedFrom":"https://base.org/api/basenames/metadata/20339294690710288616623341905746354430592698944139542544116293784975432873833"}},"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_EuuHev0xQAddKYjdDKFCW","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 on-chain and off-chain metadata for an ERC-721 or ERC-1155 token on Base, 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 20339294690710288616623341905746354430592698944139542544116293784975432873833 in the Base NFT contract 0x03c4738Ee98aE44591e1A4A4F3CaB6641d95DD9a — I want to see the owner, collection name, and image URL.","exampleUseCases":[{"title":"Basename ENS profile card lookup","prompt":"Pull up the full metadata for the Basename token with contract 0x03c4738Ee98aE44591e1A4A4F3CaB6641d95DD9a and token ID 20339294690710288616623341905746354430592698944139542544116293784975432873833 on Base — I need the owner address, name, description, and image URL."},{"title":"NFT ownership verification before trade","prompt":"Before I buy this NFT, can you confirm who currently owns token ID 1042 in the Base contract 0xd4307e0acd12cf46fd6cf93bc264f5d5d1598792 and what the token image and collection name are?"},{"title":"Display NFT gallery card details","prompt":"I'm building a gallery page — fetch the metadata for token 7 from the Base ERC-1155 contract 0xA449B4F43D9a33fCDc65d75C8B3a7E3b4E7A1234, including the image URL, name, and any description in the metadata JSON."}],"resultDescription":"Returns a JSON object with the chain ('base'), token standard (ERC-721 or ERC-1155), contract address, token ID, collection name, owner address (for ERC-721), token URI, a browser-loadable image URL, the source URL the metadata was fetched from, and the full decoded metadata JSON (name, image, description, attributes, and any custom fields) resolved from IPFS, Arweave, HTTPS, or inline data URIs.","failureModes":["Invalid contract address format (must be 0x-prefixed 40 hex chars) returns a 400 error","Token ID not matching pattern (non-numeric or too long) returns a 400 validation error","Contract does not exist on Base or is not an ERC-721/ERC-1155 returns an error or empty response","Token URI points to an unreachable IPFS/Arweave gateway causing metadata fetch failure","Token ID does not exist in the collection (unminted) may return null metadata fields","Payment not sent or invalid x402 payment header returns 402 Payment Required"],"whenToPreferThis":"Choose this endpoint when you need complete, decoded NFT metadata for a specific token on the Base blockchain — including resolving off-chain storage like IPFS or Arweave into ready-to-display image URLs — without having to write your own IPFS gateway or ABI decoding logic. Prefer it over generic RPC calls when you need the full metadata JSON and a usable image URL in one call. It is specifically scoped to Base and handles both 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:30:52.053Z","isFirstParty":false,"canonicalSlug":"base-nft-token-metadata-lookup-778492f5"}