{"uid":"cap_5JuuLVz8Zd5pmfVKBnfiT","slug":"blockscout-multichain-metadata-tags-search-985d9de2","name":"Blockscout Multichain Metadata Tags Search","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/tags:search","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":{"name":{"type":"string"},"chain_id":{"type":"string"},"page_size":{"type":"integer"},"tag_types":{"type":"string"},"page_token":{"type":"string"},"address_limit":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"tag":{"meta":"string","name":"string","slug":"string","ordinal":0,"tagType":"string"},"addresses":["string"]}],"nextPageParams":{"pageSize":0,"pageToken":"string"}}},"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__KlpjbKddPoN8pNu3l3N7","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":"Search and retrieve blockchain address tags and metadata across multiple chains by name, type, or chain ID","exampleAgentPrompt":"Search Blockscout's multichain metadata for tags named 'Uniswap' on Ethereum (chain ID 1), returning up to 10 results with their associated addresses.","exampleUseCases":[{"title":"Identify labeled DeFi protocol addresses","prompt":"Search Blockscout's tag metadata for any addresses labeled 'Aave' on Ethereum mainnet (chain ID 1) — I want to see the tag details and the contract addresses associated with that protocol."},{"title":"Discover bridge contracts by tag type","prompt":"Can you pull blockchain address tags of type 'bridge' from Blockscout's multichain metadata API, limited to 20 results? I'm trying to map out cross-chain bridge contracts."},{"title":"Audit tagged exchange addresses on Polygon","prompt":"Look up Blockscout's metadata tags for 'Binance' on Polygon (chain ID 137) and give me the list of addresses associated with that label — I need to track exchange-controlled wallets on that network."}],"resultDescription":"Returns a paginated list of tag objects, each containing a tag name, slug, type, ordinal ranking, and associated blockchain addresses, along with a nextPageParams object containing pageSize and pageToken for fetching subsequent pages.","failureModes":["Empty items array if no tags match the query name or filters","Invalid chain_id returns no results or an error response","Malformed tag_types parameter may be silently ignored or return unfiltered results","Pagination token mismatch causes repeated or missing results","Rate limiting or payment failure returns 402 or 429 status"],"whenToPreferThis":"Use this endpoint when you need to find curated metadata labels (tags) attached to blockchain addresses across multiple networks — especially when you know a protocol or entity name and want to discover its associated contract addresses. Prefer this over raw transaction search when the goal is entity identification or address labeling rather than transaction history.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:42:56.510Z","isFirstParty":false}