{"uid":"cap_gSO_iA_d-5yLTzUHitSne","slug":"blockscout-address-coin-balance-history-f7895a16","name":"Blockscout Address Coin Balance History","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/coin-balance-history","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":{"items_count":{"type":"integer"},"block_number":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"delta":"string","value":"string","block_number":0,"block_timestamp":"string","transaction_hash":"string"}],"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_oZvBlMdCayIaDTKv9_w9v","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 the historical native coin balance changes for a specific address on a given blockchain network","exampleAgentPrompt":"Can you pull the native coin balance history for address 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum (chain ID 1) using Blockscout, showing the last 50 balance change events?","exampleUseCases":[{"title":"Audit wallet inflows and outflows","prompt":"Show me every time the ETH balance changed for address 0xAbCd1234...5678 on Ethereum — I want to see the delta, value, and which block each change happened in, pulled from Blockscout."},{"title":"Monitor whale address activity","prompt":"I'm tracking a known whale wallet 0xBeEf9999...0001 on Polygon (chain ID 137). Can you pull its native coin balance history from Blockscout so I can see how its MATIC holdings shifted over time?"},{"title":"Debug unexpected balance drop","prompt":"Something weird happened to my Arbitrum wallet 0xMyAddr...5432 around block 180000000 — can you use Blockscout to fetch the coin balance history around that block so I can see what changed?"}],"resultDescription":"Returns a paginated list of native coin balance change events for the address, each containing: the balance delta (change amount), the cumulative balance value after the change, the block number where the change occurred, the block timestamp, and the transaction hash that caused the change. Also includes next_page_params for cursor-based pagination through historical records.","failureModes":["Invalid or malformed address hash returns an error or empty result","Unsupported chain_id returns a not-found or routing error","No balance history exists for a new or inactive address — returns empty items array","Pagination parameters out of range may return empty results","Rate limiting or payment failure returns 402 or 429 status"],"whenToPreferThis":"Use this endpoint when you need a chronological, block-level record of native coin (ETH, MATIC, etc.) balance changes for a specific address on a specific chain. Prefer this over token transfer endpoints when you care about the native gas token balance rather than ERC-20 tokens. It is ideal for auditing, forensics, and timeline reconstruction of wallet activity. Blockscout's multichain support means you can query the same pattern across many EVM-compatible networks by simply changing the chain_id.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:50:12.363Z","isFirstParty":false}