{"uid":"cap_uF9vJV149wE_vwjCBrI8m","slug":"blockscout-metadata-api-address-tag-lookup-67fb40b9","name":"Blockscout Metadata API – Address Tag Lookup","description":"Explore crypto activities with Blockscout's multichain search. Find transactions, addresses, tokens, and dapps across top blockchain networks — your go-to explorer for cross-chain blockchain data","url":"https://api.blockscout.com/services/metadata/api/v1/metadata","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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"chainId":{"type":"string"},"tagTypes":{"type":"string"},"addresses":{"type":"string"},"tagsLimit":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"addresses":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_I1MZscNSgBtxoX2GbjniB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves on-chain metadata tags (labels, contract names, dapp info) for one or more blockchain addresses across multiple chains via Blockscout's metadata service","exampleAgentPrompt":"Can you look up the Blockscout metadata tags for the address 0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984 on Ethereum (chainId 1) and tell me what labels or dapp associations it has?","exampleUseCases":[{"title":"Identify unknown contract address","prompt":"I see this contract address 0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2 interacting with my wallet — can you use Blockscout to look up its metadata tags on Ethereum chain 1 and tell me what it is?"},{"title":"Enrich DeFi transaction display","prompt":"For addresses 0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48 and 0x6B175474E89094C44Da98b954EedeAC495271d0F on chain 1, pull their Blockscout metadata tags so I can show human-readable labels in my transaction history."},{"title":"Screen multiple addresses for known dapp tags","prompt":"I have a list of addresses I want to check against Blockscout's metadata service on Polygon (chainId 137) — can you fetch up to 5 tags for each one and flag any that are labeled as known dapps or contracts?"}],"resultDescription":"Returns a JSON object with an 'addresses' map, where each key is a queried address and the value contains associated metadata tags — such as contract name, dapp label, tag type, and chain-specific annotations — sourced from Blockscout's curated metadata registry.","failureModes":["Invalid or malformed address returns empty or null entry for that address","Unsupported chainId may return no results or an error","Missing required 'type' or 'method' fields returns a validation error","Rate limiting or payment failure (x402) blocks the request","Very high tagsLimit values may be silently capped or cause slower responses"],"whenToPreferThis":"Use this endpoint when you need to enrich or label specific blockchain addresses with human-readable metadata (names, dapp associations, tag categories) across multiple chains. It is especially useful for displaying contract labels in UIs, screening addresses for known protocols, or resolving anonymous addresses to known entities. Prefer this over raw chain RPC calls when you want curated, cross-chain metadata rather than raw contract bytecode or transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:40:58.307Z","isFirstParty":false}