{"uid":"cap_1wfZPpWP33AqFFtH8Eb85","slug":"onchainexpat-nft-metadata-api-dd3b470a","name":"OnchainExpat NFT Metadata API","description":"Pay-per-request AI, crypto, proxy, and utility APIs using x402 protocol","url":"https://x402.onchainexpat.com/api/x402-crypto/nft-metadata","method":"POST","headers":{},"bodySchema":{"type":"object","required":["token_id","contract_address"],"properties":{"chain":{"type":"string","description":"Blockchain (default: ethereum)"},"token_id":{"type":"string","description":"Token ID of the NFT (numeric string)"},"contract_address":{"type":"string","description":"NFT contract address (0x + 40 hex chars)"}}},"responseSchema":{"type":"object","properties":{"data":{"type":"object","properties":{"chain":{"type":"string"},"owner":{"type":"string","description":"Current owner address"},"metadata":{"type":"object","description":"NFT name, description, image URL, attributes"},"token_id":{"type":"string"},"collection":{"type":"object","description":"Collection name, symbol, total supply"},"explorer_url":{"type":"string","description":"Link to view NFT on block explorer"},"contract_address":{"type":"string"},"transfer_history":{"type":"array","description":"Recent transfer history"}}},"success":{"type":"boolean"}}},"example":{"request":{"token_id":"1","contract_address":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"},"response":{"data":{"chain":"ethereum","rarity":{"note":"Full rarity score requires collection-wide data. This shows trait overview only.","trait_count":5,"trait_types":["Mouth","Clothes","Background","Eyes","Fur"]},"metadata":{"name":"Token #1","image":"https://ipfs.io/ipfs/QmPbxeGcXhYQQNgsC6a36dDyYUcHgMLnGKnF8pVFmGsvqi","attributes":[{"value":"Grin","trait_type":"Mouth"},{"value":"Vietnam Jacket","trait_type":"Clothes"},{"value":"Orange","trait_type":"Background"},{"value":"Blue Beams","trait_type":"Eyes"},{"value":"Robot","trait_type":"Fur"}],"description":null,"external_url":null,"animation_url":null},"token_id":"1","ownership":{"current_owner":"0x46efbaedc92067e6d60e84ed6395099723252496","last_transfer":null,"first_transfer":null,"transfer_count":0},"transfers":[],"chain_name":"Ethereum","collection":{"name":"Bored Ape Yacht Club","type":"pfp","verified":true},"contract_address":"0xbc4ca0eda7647a8ab7c2061c2e118a18a936f13d"},"cached":false,"success":true,"timestamp":"2026-06-18T05:55:02.560886+00:00"}},"exampleRequest":{"token_id":"1","contract_address":"0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_QUMoEXKCp0lj4VmNnhwOE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","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 token using the x402 pay-per-request protocol","exampleAgentPrompt":"Can you look up the metadata for NFT token ID 1234 on the Bored Ape Yacht Club contract 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D on Ethereum — I want to see its name, image, and trait attributes.","exampleUseCases":null,"resultDescription":"A JSON object containing the NFT's metadata including name, description, image URL, external URL, and an array of trait attributes (e.g. background, eyes, fur) for the specified token.","failureModes":["Invalid or non-existent contract address returns an error","Token ID not found on the given contract returns a 404-style error","Unsupported blockchain network returns an error","Payment not included or insufficient USDC balance returns a 402 payment required response","Rate limiting or network congestion may cause timeouts"],"whenToPreferThis":"Use this endpoint when you need on-chain NFT metadata (name, image, traits) for a specific token by contract address and token ID, especially in a pay-per-request context without needing a monthly subscription to a larger NFT data platform like OpenSea or Alchemy.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T06:52:43.062Z","isFirstParty":false}