{"uid":"cap_1E0ZXxOJtF6-brz8JYn2t","slug":"blockscout-address-token-holdings-lookup-35440b7a","name":"Blockscout Address Token Holdings 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/%7Bchain_id%7D/api/v2/addresses/%7Baddress_hash_param%7D/tokens","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"},"pathParams":{"type":"object","properties":{"chain_id":{"type":"string"},"address_hash_param":{"type":"string"}}},"queryParams":{"type":"object","properties":{"id":{"type":"integer"},"type":{"type":"string"},"value":{"type":"string"},"fiat_value":{"type":"string"},"items_count":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"token":{},"value":"string","token_id":"string","token_instance":{}}],"next_page_params":{}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_kvzlS2KeNuEf7r41YUxkR","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves all tokens held by a specific blockchain address on a given chain via Blockscout's multichain explorer","exampleAgentPrompt":"Can you look up all tokens held by the wallet address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum mainnet (chain ID 1) using Blockscout?","exampleUseCases":[{"title":"DeFi portfolio audit for a wallet","prompt":"Show me every token — ERC-20s and NFTs — currently held by the address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Polygon (chain ID 137) so I can see their full on-chain portfolio."},{"title":"NFT holdings verification for a user","prompt":"I need to verify which NFTs the address 0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B holds on Base (chain ID 8453) — can you pull the full token list from Blockscout?"},{"title":"Compliance check on a flagged address","prompt":"Pull all token holdings for the address 0x742d35Cc6634C0532925a3b844Bc454e4438f44e on Arbitrum (chain ID 42161) — I need to see what ERC-20s they're sitting on for a compliance review."}],"resultDescription":"Returns a paginated list of token holdings for the specified address on the specified chain. Each item includes the token object (metadata like name, symbol, type), the balance value as a string, an optional token ID (for NFTs), and token instance details. Also includes next_page_params for cursor-based pagination through large portfolios.","failureModes":["Invalid or malformed address hash returns an error or empty result","Unsupported or incorrect chain_id returns a 404 or empty response","Address with no token holdings returns an empty items array","Pagination cursor mismatch causes duplicate or missing results","Rate limiting or payment failures (x402) if payment is not properly attached"],"whenToPreferThis":"Choose this endpoint when you need to enumerate all token holdings (ERC-20, ERC-721, ERC-1155) for a specific address on a specific chain supported by Blockscout. It is ideal for wallet portfolio analysis, compliance checks, NFT ownership verification, and DeFi auditing. Prefer this over generic block explorers when you need structured JSON output with pagination support across multiple EVM-compatible chains in a single API family.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:49:59.315Z","isFirstParty":false}