{"uid":"cap_F7jhxaBzWrt37YaoDh5Qg","slug":"blockscout-transaction-state-changes-13791c69","name":"Blockscout Transaction State Changes","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/transactions/%7Btransaction_hash_param%7D/state-changes","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"},"transaction_hash_param":{"type":"string"}}},"queryParams":{"type":"object","properties":{"items_count":{"type":"integer"},"state_changes_count":{"type":"integer"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"items":[{"type":"string","token":{},"change":"string","address":{"hash":"string","name":"string","is_scam":true,"metadata":{},"proxy_type":"string","reputation":"string","is_contract":true,"is_verified":true,"public_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"private_tags":[{"label":"string","address_hash":"string","display_name":"string"}],"ens_domain_name":"string","implementations":[{"name":"string","address_hash":"string"}],"watchlist_names":[{"label":"string","display_name":"string"}]},"is_miner":true,"token_id":"string","balance_after":"string","balance_before":"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_430MAfk_pdDfc3k-lyXoi","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 state changes (balance and token changes) caused by a specific transaction on a given blockchain network","exampleAgentPrompt":"Show me all the state changes from transaction 0x4f2b...e91a on the Ethereum mainnet (chain ID 1) — I want to see which addresses had their balances changed and by how much before and after.","exampleUseCases":[{"title":"DeFi trade impact analysis","prompt":"For this Uniswap swap transaction 0xabc123...def on chain ID 1, show me all the token balance changes — I want to know exactly which wallets sent and received tokens and what their balances looked like before and after the swap."},{"title":"Suspicious transaction forensics","prompt":"I'm investigating a potentially malicious transaction 0xdead...beef on Polygon (chain ID 137) — can you pull all state changes so I can see every address that was touched and what balances changed?"},{"title":"NFT transfer state verification","prompt":"Check the state changes for transaction 0x7890...abcd on Ethereum (chain ID 1) — I need to confirm which addresses gained or lost token balances and whether any miner addresses were involved."}],"resultDescription":"Returns a paginated list of state change items, each containing the affected address (with metadata like name, ENS domain, tags, scam flag, contract status), the type of change, the token involved (if any), token ID, balance before and after the transaction, whether the address is a miner, and pagination parameters for fetching additional results.","failureModes":["Invalid or malformed transaction hash returns 404 or empty result","Unsupported chain_id returns an error or no data","Transaction hash exists but has no state changes (e.g. failed tx) returns empty items array","Pagination params out of range may return empty next page","Rate limiting or payment failure returns 402 or 429 error"],"whenToPreferThis":"Use this endpoint when you need granular, per-address balance and token state diffs for a specific transaction — particularly for DeFi analysis, forensics, auditing, or reconciliation. Prefer this over general transaction detail endpoints when you specifically need before/after balance snapshots and all affected parties. The multichain support via chain_id makes it ideal when working across networks without switching APIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T06:45:52.697Z","isFirstParty":false}