{"uid":"cap_7mE98w_ekI-WeWcGp2EId","slug":"dopaminedesk-token-metadata-bulk-lookup-16344ce6","name":"DopamineDesk Token Metadata Bulk Lookup","description":"Read ERC-20 symbol, name, decimals, and raw total supply for up to ten contract addresses using live eth_call requests.","url":"https://ai-data-marketplace-1042299154756.us-central1.run.app/api/v1/token_metadata_bulk","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":["addresses"],"properties":{"chain":{"type":"string","description":"Blockchain network (default: ethereum)."},"addresses":{"type":"array","items":{"type":"string"},"description":"Array of contract addresses."}},"additionalProperties":true}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success","source","fetched_at","network","count","tokens","marketplace_metadata"],"properties":{"count":{"type":"integer"},"source":{"type":"string"},"tokens":{"type":"array","items":{"type":"object","required":["address","symbol","name","decimals","total_supply_raw"],"properties":{"name":{"type":"string"},"symbol":{"type":"string"},"address":{"type":"string"},"decimals":{"type":"string"},"total_supply_raw":{"type":"string"}},"additionalProperties":true}},"network":{"type":"string"},"success":{"type":"boolean"},"fetched_at":{"type":"string"},"marketplace_metadata":{"type":"object","required":["data_mode","billable","availability","source"],"properties":{"source":{"type":"string"},"billable":{"type":"boolean"},"data_mode":{"type":"string"},"availability":{"type":"string"}},"additionalProperties":true}},"additionalProperties":true}}}}},"responseSchema":{"type":"json","example":{"count":2,"source":"ethereum public JSON-RPC","tokens":["[nested detail omitted from the challenge header; see the full example in /openapi.json]"],"network":"ethereum","success":true,"fetched_at":"2026-08-07T07:32:33.479Z","marketplace_metadata":{"source":"public EVM JSON-RPC","billable":true,"data_mode":"live_source","availability":"operational"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p7ezSiddtfwOWamRT3F9x","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches metadata (name, symbol, logo, decimals) for multiple ERC-20/token contract addresses in a single call on a specified blockchain network.","exampleAgentPrompt":"Look up the token metadata — name, symbol, logo, and decimals — for these Ethereum contract addresses: 0xabc123..., 0xdef456..., and 0x789xyz... all at once.","exampleUseCases":[{"title":"DeFi portfolio token enrichment","prompt":"I have a list of Ethereum token contract addresses from my wallet — 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48, 0x6B175474E89094C44Da98b954EedeAC495271d0F, and 0xdAC17F958D2ee523a2206206994597C13D831ec7 — can you fetch the name, symbol, logo, and decimals for all of them at once?"},{"title":"Token symbol resolution for DEX UI","prompt":"We're building a decentralized exchange interface and need the names, symbols, and logos for these five Base network token contracts: 0x111..., 0x222..., 0x333..., 0x444..., 0x555... — grab their metadata in one shot."},{"title":"Blockchain security due diligence enrichment","prompt":"I'm running due diligence on several token contracts on Ethereum and need to verify their official names, symbols, and decimal precision — the addresses are 0xaaa..., 0xbbb..., and 0xccc.... Pull the metadata for all three."}],"resultDescription":"Returns an array of token metadata objects, each containing the token's logo URL, full name, ticker symbol, contract address, and decimal precision for the requested contracts on the specified chain.","failureModes":["Invalid or non-existent contract address returns missing or null fields for that entry","Unsupported blockchain network returns an error or empty results","Malformed address array causes a 400 bad request","Network or upstream data source downtime returns 503 or timeout","Payment failure via x402 returns 402 Payment Required"],"whenToPreferThis":"Use this endpoint when you need to resolve multiple token contract addresses to human-readable metadata in a single API call, especially in DeFi, portfolio, or security workflows on Ethereum or other supported chains. It is more cost-efficient than making individual token metadata lookups when processing lists of 2+ contracts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:42:31.882Z","isFirstParty":false}