Blockscout
App · Cryptocurrency · 30 actions
Read any EVM chain through Blockscout, the open-source block explorer behind Ethereum, Optimism, Base, Arbitrum, Polygon, Gnosis, zkSync and a hundred more. Look up an address's balance, tokens, NFTs and history, follow a transaction with its decoded method call and events, read blocks, tokens, holders and verified contract source, and search a chain by name, address or hash. One PRO API key from dev.blockscout.com reaches every chain, and the free plan covers all but Base, Polygon and zkSync; each step picks its chain from a dropdown. Amounts come back in raw units and whole coins, gas in gwei and timestamps as dates, and every address carries the name, ENS and labels Blockscout knows it by.
Actions
| Action | What it does |
|---|---|
| Get a block | Get one block: when it was mined, who produced it, how many transactions it holds, how full it was, its base fee and the fees it burned and paid out. |
| Get a token | Look up a token by its contract: its name, symbol, decimals and standard, total supply, how many addresses hold it and how many times it has moved, its price, market cap and daily volume where it trades, and whether Blockscout flags it as a scam. |
| Get a transaction | Get one transaction in full: whether it succeeded and why not if it failed, who sent it to whom - with their names and labels - the value and fee, the gas it used and paid, the method it called decoded by name with its arguments, and how many blocks deep it is. |
| Get a verified contract | Get a verified contract's name, source code and ABI, the compiler and settings it was built with, its licence, the arguments it was deployed with, and - when it is a proxy - the implementation it points at. |
| Get an address | Look up a wallet or contract: its native coin balance in wei, whole coins and US dollars, what Blockscout calls it - contract name, ENS name, public labels such as an exchange's deposit wallet - whether it is a contract, verified, a proxy or flagged as a scam, how many transactions and token transfers it has made, and who deployed it if it is a contract. |
| Get an address's daily balance history | Get an address's native coin balance at the end of each of the last days Blockscout tracked, oldest first - the series behind the balance chart on its page, ready to plot or to compare with last week. |
| Get an NFT | Look up one NFT by its collection and token id: its name, description, image and traits from its metadata, who owns it now, and the collection it belongs to. |
| Get block number by date and time | Find the block produced at a given moment - the bridge between a date and the block numbers the other actions take. |
| Get chain statistics | Get a snapshot of a chain right now: how many blocks, transactions and addresses it has, how many transactions it carried today, its average block time, how busy it is, the native coin's price and market cap, and the gas prices being paid. |
| Get daily transaction counts | Get how many transactions a chain carried on each of the last thirty days, oldest first - the series behind the activity chart on the explorer's front page, ready for a chart or a week-over-week comparison. |
| Get gas prices | Get the gas prices a chain is asking right now, in gwei, for a slow, an average and a fast transaction - the numbers behind the gas tracker on the explorer. |
| Get the native coin's price history | Get the native coin's closing price and market cap in US dollars for each of the last thirty days, oldest first, plus its available supply. |
| List a block's transactions | List the transactions a block confirmed, in the order they were mined, each with its value, fee, status and decoded method. |
| List a contract's event logs | List the events a contract emitted, newest first, each decoded against its ABI when Blockscout knows it - so a Transfer arrives with its from, to and value as named fields rather than as hex topics. |
| List a token's holders | List the addresses holding the most of a token, largest first, each with its holding in raw and whole units, its share of the supply, and the name Blockscout knows the holder by - an exchange, a pool, a treasury. |
| List a token's transfers | List the latest transfers of one token, newest first - who sent how much to whom, in raw and whole units, and in which transaction. |
| List a transaction's event logs | List the events one transaction emitted, each decoded against the emitting contract's ABI when Blockscout knows it, so an Approval or a Swap arrives with named fields. |
| List a transaction's internal transactions | Break one transaction open and list every call and value move it set off inside contracts - the way to see where the money actually went in a multi-step contract call, and which inner call failed when one did. |
| List a transaction's token transfers | List every token that moved inside one transaction - each with the token's name, symbol and decimals, who sent it to whom, and the amount in raw and whole units. |
| List an address's internal transactions | List the internal transactions that touched an address - the value moves a contract made on its own, which never appear in the normal transaction list. |
| List an address's NFTs | List the NFTs an address holds, each with its collection, token id, name, image and traits from its metadata - and, for an ERC-1155, how many of that token id it has. |
| List an address's token balances | List every token an address holds, most valuable first, each with the token's name, symbol and price and the holding in raw units, whole tokens and US dollars - plus the portfolio's total in dollars. |
| List an address's token transfers | List the token transfers that touched an address, newest first - ERC-20 payments, NFTs changing hands, ERC-1155 quantities - each with the token's name, symbol and decimals and the amount in both raw and whole units. |
| List an address's transactions | List the transactions an address sent or received, newest first, each with its value, fee, whether it succeeded, the method it called decoded by name, and who was on the other end - with their names and labels. |
| List recent blocks | List the most recently mined blocks, newest first, with when each was mined, who produced it, what is in it and how full it was. |
| List recent transactions | List the latest transactions on a chain, newest first - the live feed on the explorer's front page - or the ones still waiting to be mined. |
| List supported chains | List every chain the Blockscout PRO API covers - Ethereum, Optimism, Base, Arbitrum, Polygon, Gnosis, zkSync and a hundred more, testnets included - with each one's chain id, native coin and explorer, and whether it needs a paid plan. |
| List the richest addresses | List the addresses holding the most of a chain's native coin, largest first, each with its balance in coins and US dollars, its transaction count and the name Blockscout knows it by - an exchange, a bridge, a staking contract. |
| Search a chain | Search a chain the way the explorer's search box does: by a token or contract name, an ENS name, a public label, or a partial address, hash or block number. |
| Search tokens | Find tokens on a chain by name or symbol, most held first, each with its contract address, standard, decimals, holder count and price - the way to turn 'USDC on Base' into the contract address the other token actions take. |
Get a block
Get one block: when it was mined, who produced it, how many transactions it holds, how full it was, its base fee and the fees it burned and paid out. Name it by number or by hash, or leave the field blank for the newest block - which is how a workflow checks the chain is moving.
Inputs
- Block
blocktext - The block number, or its 66-character hash. Leave blank for the newest block.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
base_fee_per_gasnumber- Its base fee, in wei.
base_fee_per_gas_gweitext- Its base fee, in gwei, the unit gas is quoted in.
burnt_feesnumber- The fees burned in it, in the smallest unit (wei), exact.
burnt_fees_unitstext- The fees burned in it, in whole coins, as a decimal string so nothing is rounded.
chain_idtext- The chain the call was made against, as its chain id.
difficultynumber- The mining difficulty. Zero after the Merge.
gas_limitnumber- The gas limit it had.
gas_target_percentagenumber- How far above or below the EIP-1559 gas target it landed, as a percentage.
gas_usednumber- The gas its transactions used.
gas_used_percentagenumber- How full it was, as a percentage of the limit.
hashtext- A 66-character hash.
heightnumber- The block number.
internal_transactions_countnumber- How many internal transactions those set off.
minerobject- Who an address is, as far as Blockscout knows.
noncetext- The proof-of-work nonce, as hex. Zero after the Merge.
parent_hashtext- The hash of the block before it.
priority_feenumber- The tips its validator collected, in the smallest unit (wei), exact.
priority_fee_unitstext- The tips its validator collected, in whole coins, as a decimal string so nothing is rounded.
rewardslist- What the block paid its producer.
sizenumber- Its size in bytes.
timestamptext- When it was mined, as a UTC date and time (2026-10-06T04:01:11Z).
timestamp_unixnumber- When it was mined, as unix seconds.
transaction_feesnumber- All the fees its transactions paid, in the smallest unit (wei), exact.
transaction_fees_unitstext- All the fees its transactions paid, in whole coins, as a decimal string so nothing is rounded.
transactions_countnumber- How many transactions it holds.
typetext- block, uncle or reorg.
uncles_countnumber- How many uncle blocks it includes.
withdrawals_countnumber- How many beacon-chain withdrawals it processed. Null on chains without them.
Example output
{
"base_fee_per_gas": 602463848,
"base_fee_per_gas_gwei": "0.602463848",
"burnt_fees": 13167593573480016,
"burnt_fees_units": "0.013167593573480016",
"chain_id": "1",
"difficulty": 0,
"gas_limit": 45000000,
"gas_target_percentage": -2.86,
"gas_used": 21856422,
"gas_used_percentage": 48.57,
"hash": "0xbead83234625054fe1f58d54d57f3ed76980a9cc320f22d6e2a8e6a512748f69",
"height": 26128184,
"internal_transactions_count": 82,
"miner": {
"ens_name": null,
"hash": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": "beaverbuild",
"name": null,
"proxy_type": null,
"tags": [
"beaverbuild"
]
},
"nonce": "0x0000000000000000",
"parent_hash": "0x598d814e2b417168410c102175e5ea90ae5cd787e4798aac0db47062d7464436",
"priority_fee": 2118838534209984,
"priority_fee_units": "0.002118838534209984",
"rewards": [
{
"reward": 2118838534209984,
"reward_units": "0.002118838534209984",
"type": "Validator Reward"
}
],
"size": 87639,
"timestamp": "2026-10-05T19:13:11Z",
"timestamp_unix": 1791227591,
"transaction_fees": 15286432107690000,
"transaction_fees_units": "0.01528643210769",
"transactions_count": 163,
"type": "block",
"uncles_count": 0,
"withdrawals_count": 16
}Get a token
Look up a token by its contract: its name, symbol, decimals and standard, total supply, how many addresses hold it and how many times it has moved, its price, market cap and daily volume where it trades, and whether Blockscout flags it as a scam.
Inputs
- Token contract address
token_addresstextRequired - The token's contract address.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
decimalsnumber- How many decimal places the token has. Null for NFTs.
holders_countnumber- How many addresses hold it.
icon_urltext- The token's icon, when Blockscout has one.
is_bridgedtrue/false- Whether this is a bridged copy of a token from another chain.
market_cap_usdnumber- The circulating market cap in US dollars.
nametext- The token's name.
price_usdnumber- The token's price in US dollars, when it has one.
reputationtext- Blockscout's view of the token: ok, or scam.
symboltext- The token's ticker symbol.
total_supplynumber- The total supply in the smallest unit.
total_supply_unitstext- The total supply in whole tokens. For an NFT collection, how many tokens exist.
transfers_countnumber- How many times the token has been transferred.
typetext- The token standard: ERC-20, ERC-721, ERC-1155 or ERC-404.
volume_24h_usdnumber- Trading volume over the last day, in US dollars.
Example output
{
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"chain_id": "1",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"transfers_count": 337220755,
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
}Get a transaction
Get one transaction in full: whether it succeeded and why not if it failed, who sent it to whom - with their names and labels - the value and fee, the gas it used and paid, the method it called decoded by name with its arguments, and how many blocks deep it is. Also the step to poll while a payment confirms: status reads pending until it is mined.
Inputs
- Transaction hash
transaction_hashtextRequired - The 66-character transaction hash, starting with 0x.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
base_fee_per_gasnumber- The block's base fee when it was mined, in wei.
base_fee_per_gas_gweitext- The block's base fee when it was mined, in gwei, the unit gas is quoted in.
block_numbernumber- The block that contains it. Null while pending.
burnt_feenumber- The part of the fee that was burned, in the smallest unit (wei), exact.
burnt_fee_unitstext- The part of the fee that was burned, in whole coins, as a decimal string so nothing is rounded.
chain_idtext- The chain the call was made against, as its chain id.
confirmationsnumber- How many blocks deep it is.
created_contractobject- Who an address is, as far as Blockscout knows.
decoded_parameterslist- The call's arguments, decoded against the ABI.
feenumber- What the sender paid in fees, in the smallest unit (wei), exact.
fee_unitstext- What the sender paid in fees, in whole coins, as a decimal string so nothing is rounded.
fromobject- Who an address is, as far as Blockscout knows.
gas_limitnumber- The gas limit it set.
gas_pricenumber- The gas price it paid, in wei.
gas_price_gweitext- The gas price it paid, in gwei, the unit gas is quoted in.
gas_usednumber- The gas it actually used.
has_error_in_internal_transactionstrue/false- Whether any internal call inside it failed.
hashtext- A 66-character hash.
max_fee_per_gasnumber- The most it offered per unit of gas (EIP-1559), in wei.
max_fee_per_gas_gweitext- The most it offered per unit of gas (EIP-1559), in gwei, the unit gas is quoted in.
max_priority_fee_per_gasnumber- The tip it offered the validator (EIP-1559), in wei.
max_priority_fee_per_gas_gweitext- The tip it offered the validator (EIP-1559), in gwei, the unit gas is quoted in.
methodtext- The contract method it called, by name when the ABI is known (transfer, swap) and by 4-byte id otherwise. Null for a plain transfer.
method_calltext- The full decoded call signature, such as transfer(address to, uint256 value).
noncenumber- The sender's transaction count when it was sent.
positionnumber- Its position within the block.
resulttext- Blockscout's own word on the outcome: success, pending, or the error.
revert_reasontext- Why it reverted, when a failed call said.
statustext- success, failed, or pending while it waits to be mined.
successtrue/false- Whether it succeeded. Null while it is still pending - the value a branch step should read.
timestamptext- When its block was mined, as a UTC date and time (2026-10-06T04:01:11Z).
timestamp_unixnumber- When its block was mined, as unix seconds.
toobject- Who an address is, as far as Blockscout knows.
token_transfers_countnumber- How many token transfers it set off, when the record carries them.
transaction_typeslist- What kind of transaction it is: coin_transfer, contract_call, token_transfer, contract_creation and so on. One transaction can be several.
typenumber- The EIP-2718 transaction type (0 legacy, 2 EIP-1559).
valuenumber- The native coins it moved, in the smallest unit (wei), exact.
value_unitstext- The native coins it moved, in whole coins, as a decimal string so nothing is rounded.
Example output
{
"base_fee_per_gas": 602463848,
"base_fee_per_gas_gwei": "0.602463848",
"block_number": 26128184,
"burnt_fee": 12689073557676,
"burnt_fee_units": "0.000012689073557676",
"chain_id": "1",
"confirmations": 3347,
"created_contract": null,
"decoded_parameters": [],
"fee": 12689073557676,
"fee_units": "0.000012689073557676",
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"gas_limit": 21062,
"gas_price": 602463848,
"gas_price_gwei": "0.602463848",
"gas_used": 21062,
"has_error_in_internal_transactions": false,
"hash": "0x337ee39459dd802c05f566ff8c1898bb99703eb307594cbd2e5d2945af85ff7a",
"max_fee_per_gas": 3204925796,
"max_fee_per_gas_gwei": "3.204925796",
"max_priority_fee_per_gas": 2000000000,
"max_priority_fee_per_gas_gwei": "2",
"method": null,
"method_call": null,
"nonce": 14,
"position": 103,
"result": "success",
"revert_reason": null,
"status": "success",
"success": true,
"timestamp": "2026-10-05T19:13:11Z",
"timestamp_unix": 1791227591,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token_transfers_count": 0,
"transaction_types": [
"coin_transfer"
],
"type": 2,
"value": 3690640000000000,
"value_units": "0.00369064"
}Get a verified contract
Get a verified contract's name, source code and ABI, the compiler and settings it was built with, its licence, the arguments it was deployed with, and - when it is a proxy - the implementation it points at. The function and event names are pulled out of the ABI so a workflow can read them without parsing it. is_verified is false rather than an error when the source was never published.
Inputs
- Contract address
addresstextRequired - The address of the contract.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
abilist- The contract's ABI, as a web3 library expects it.
additional_sources_countnumber- How many further source files it imports.
addresstext- A 42-character address, lowercased.
certifiedtrue/false- Whether Blockscout marks the contract as certified.
chain_idtext- The chain the call was made against, as its chain id.
compiler_versiontext- The compiler version it was built with.
constructor_argumentslist- The arguments it was deployed with, decoded.
constructor_arguments_rawtext- Those arguments ABI-encoded, as hex.
event_nameslist- The names of the events in the ABI, sorted.
evm_versiontext- The EVM version it targets.
external_librarieslist- The libraries it is linked against.
file_pathtext- The path of the main source file.
function_nameslist- The names of the functions in the ABI, sorted.
implementation_addresstext- For a proxy, the contract it currently points at.
implementation_nametext- That implementation's verified name.
is_blueprinttrue/false- Whether it is a Vyper blueprint.
is_changed_bytecodetrue/false- Whether the deployed bytecode has changed since verification.
is_fully_verifiedtrue/false- Whether every part of the source, metadata included, matched.
is_partially_verifiedtrue/false- Whether only the bytecode matched, not the metadata.
is_verifiedtrue/false- Whether the source is published and matches the bytecode.
languagetext- solidity, vyper or yul.
license_typetext- The licence the source is published under.
nametext- The contract's name.
optimization_enabledtrue/false- Whether the optimizer was on.
optimization_runsnumber- The optimizer's runs setting.
proxy_typetext- For a proxy, which pattern it follows. Null otherwise.
source_codetext- The main source file, in full.
sourcify_repo_urltext- Where Sourcify keeps the source, when it verified it.
verified_attext- When it was verified, as a UTC date and time.
verified_viatext- Which service verified it: blockscout, sourcify, eth_bytecode_db or verifier_alliance.
Example output
{
"abi": [
{
"inputs": [],
"name": "implementation",
"outputs": [
{
"name": "",
"type": "address"
}
],
"stateMutability": "view",
"type": "function"
}
],
"additional_sources_count": 4,
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"certified": false,
"chain_id": "1",
"compiler_version": "v0.6.12+commit.27d51765",
"constructor_arguments": [
{
"name": "implementationContract",
"type": "address",
"value": "0xbd17DEee53a58B48548117a11a2E7bbF2D0d6Fa7"
}
],
"constructor_arguments_raw": "0x000000000000000000000000bd17deee53a58b48548117a11a2e7bbf2d0d6fa7",
"event_names": [
"AdminChanged",
"Upgraded"
],
"evm_version": "istanbul",
"external_libraries": [],
"file_path": "contracts/v1/FiatTokenProxy.sol",
"function_names": [
"admin",
"changeAdmin",
"implementation",
"upgradeTo"
],
"implementation_address": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
"implementation_name": "FiatTokenV2_2",
"is_blueprint": false,
"is_changed_bytecode": false,
"is_fully_verified": true,
"is_partially_verified": false,
"is_verified": true,
"language": "solidity",
"license_type": "none",
"name": "FiatTokenProxy",
"optimization_enabled": true,
"optimization_runs": 10000000,
"proxy_type": "eip1967",
"source_code": "pragma solidity 0.6.12;\n\ncontract FiatTokenProxy is AdminUpgradeabilityProxy { ... }\n",
"sourcify_repo_url": null,
"verified_at": "2023-09-05T20:52:29Z",
"verified_via": "blockscout"
}Get an address
Look up a wallet or contract: its native coin balance in wei, whole coins and US dollars, what Blockscout calls it - contract name, ENS name, public labels such as an exchange's deposit wallet - whether it is a contract, verified, a proxy or flagged as a scam, how many transactions and token transfers it has made, and who deployed it if it is a contract. The step to put in front of a decision about an unknown address.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
balancenumber- The native coin balance, in the smallest unit (wei), exact.
balance_unitstext- The native coin balance, in whole coins, as a decimal string so nothing is rounded.
balance_updated_at_blocknumber- The block the balance was last recomputed at.
balance_usdnumber- That balance in US dollars.
chain_idtext- The chain the call was made against, as its chain id.
coin_price_usdnumber- The native coin's price in US dollars the balance was valued at.
creation_transaction_hashtext- For a contract, the transaction that deployed it.
creator_addresstext- For a contract, who deployed it.
ens_nametext- The ENS name that points at it, if one does.
gas_usednumber- How much gas its transactions have used.
has_logstrue/false- Whether it has emitted any events.
has_token_transferstrue/false- Whether any token transfers have touched it.
has_tokenstrue/false- Whether it holds any tokens.
has_validated_blockstrue/false- Whether it has ever produced a block.
hashtext- A 42-character address, lowercased.
implementation_addresstext- For a proxy, the contract it currently points at.
implementation_nametext- That implementation's verified name.
is_contracttrue/false- Whether this is a contract rather than a wallet.
is_scamtrue/false- Whether Blockscout flags this address as a scam.
is_verifiedtrue/false- Whether the contract's source code is published and verified.
labeltext- The best human name available: the contract name, else the ENS name, else the first public tag. Null when there is none.
nametext- The name Blockscout knows the address by - a verified contract's name, usually. Null for an ordinary wallet.
proxy_typetext- For a proxy contract, which pattern it follows (eip1967, eip1167, eip7702...). Null otherwise.
tagslist- The public labels Blockscout attaches - exchange deposit wallets, protocol contracts, project names.
tokenobject- A token, as Blockscout describes it.
token_transfers_countnumber- How many token transfers have touched it.
transactions_countnumber- How many transactions the address has sent or received.
validated_blocks_countnumber- How many blocks it has produced, if it is a validator.
Example output
{
"balance": 5753008902866090346,
"balance_units": "5.753008902866090346",
"balance_updated_at_block": 26131526,
"balance_usd": 15491.3,
"chain_id": "1",
"coin_price_usd": 2692.73,
"creation_transaction_hash": null,
"creator_address": null,
"ens_name": "vitalik.eth",
"gas_used": 1210769127,
"has_logs": false,
"has_token_transfers": true,
"has_tokens": true,
"has_validated_blocks": false,
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
],
"token": null,
"token_transfers_count": 403557,
"transactions_count": 78373,
"validated_blocks_count": 0
}Get an address's daily balance history
Get an address's native coin balance at the end of each of the last days Blockscout tracked, oldest first - the series behind the balance chart on its page, ready to plot or to compare with last week.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many days were returned.
dayslist- One entry per day, oldest first.
Example output
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain_id": "1",
"count": 2,
"days": [
{
"balance": 5721681785331996621,
"balance_units": "5.721681785331996621",
"date": "2026-10-04"
},
{
"balance": 5753008902866090346,
"balance_units": "5.753008902866090346",
"date": "2026-10-05"
}
]
}Get an NFT
Look up one NFT by its collection and token id: its name, description, image and traits from its metadata, who owns it now, and the collection it belongs to.
Inputs
- Collection contract address
token_addresstextRequired - The NFT collection's contract address.
- Token id
token_idtextRequired - Which token in the collection, as a whole number.
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
animation_urltext- Its animation or video, when it has one.
attributeslist- Its traits from the metadata.
chain_idtext- The chain the call was made against, as its chain id.
descriptiontext- Its description from the metadata.
external_urltext- A link to the NFT on its own project's site.
image_urltext- Its image.
is_uniquetrue/false- Whether only one of this token id exists.
media_typetext- That media's MIME type, when known.
media_urltext- The media Blockscout chose to show for it.
nametext- Its name from the metadata.
ownerobject- Who an address is, as far as Blockscout knows.
quantitynumber- For an ERC-1155, how many of this token id the address holds. Null for a lookup of one NFT.
tokenobject- A token, as Blockscout describes it.
token_idtext- The token id within the collection, as a decimal string.
token_typetext- ERC-721, ERC-1155 or ERC-404.
Example output
{
"animation_url": null,
"attributes": [
{
"display_type": null,
"trait": "generation",
"value": "0"
},
{
"display_type": null,
"trait": "fancy_type",
"value": "Genesis"
}
],
"chain_id": "1",
"description": null,
"external_url": null,
"image_url": "https://img.cryptokitties.co/0x06012c8cf97bead5deae237070f9587f8e7a266d/1.png",
"is_unique": true,
"media_type": null,
"media_url": "https://img.cryptokitties.co/0x06012c8cf97bead5deae237070f9587f8e7a266d/1.png",
"name": "Genesis",
"owner": {
"ens_name": null,
"hash": "0x88207b431510dbe0addbdae3bd53013813fc8c71",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"quantity": null,
"token": {
"address": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
"decimals": null,
"holders_count": 112345,
"icon_url": null,
"is_bridged": null,
"market_cap_usd": null,
"name": "CryptoKitties",
"price_usd": null,
"reputation": "ok",
"symbol": "CK",
"total_supply": 2024521,
"total_supply_units": "2024521",
"type": "ERC-721",
"volume_24h_usd": null
},
"token_id": "1",
"token_type": "ERC-721"
}Get block number by date and time
Find the block produced at a given moment - the bridge between a date and the block numbers the other actions take. Pick the date and time and this converts it; choose whether you want the last block before that moment or the first one after.
Inputs
- Date and time
timestampdate and timeRequired - The moment to find the block for.
- Which block
closesttext - The last block at or before that moment, or the first one at or after it. Before by default.One of:
before(The last block at or before that moment),after(The first block at or after that moment). Default:before. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
block_numbernumber- The block's number.
chain_idtext- The chain the call was made against, as its chain id.
closesttext- Which side of the moment the block is on: before or after.
timestamptext- The moment that was asked about, as a UTC date and time (2026-10-06T04:01:11Z).
timestamp_unixnumber- The moment that was asked about, as unix seconds.
Example output
{
"block_number": 18908894,
"chain_id": "1",
"closest": "before",
"timestamp": "2024-01-01T00:00:00Z",
"timestamp_unix": 1704067200
}Get chain statistics
Get a snapshot of a chain right now: how many blocks, transactions and addresses it has, how many transactions it carried today, its average block time, how busy it is, the native coin's price and market cap, and the gas prices being paid. The one call behind a chain status board.
Inputs
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
average_block_time_secondsnumber- How many seconds apart blocks are, on average.
chain_idtext- The chain the call was made against, as its chain id.
coin_price_change_percentagenumber- How much that price moved over the last day, as a percentage.
coin_price_usdnumber- The native coin's price in US dollars.
gas_average_gweinumber- The gas price for an average one, in gwei.
gas_fast_gweinumber- The gas price for a fast one, in gwei.
gas_prices_updated_attext- When those gas prices were last refreshed, as a UTC date and time.
gas_slow_gweinumber- The gas price for a slow transaction, in gwei.
gas_used_todaynumber- How much gas was used today.
market_cap_usdnumber- The coin's market cap in US dollars.
network_utilization_percentagenumber- How full recent blocks have been, as a percentage.
total_addressesnumber- How many addresses have ever appeared on it.
total_blocksnumber- How many blocks the chain has.
total_transactionsnumber- How many transactions it has ever carried.
transactions_todaynumber- How many transactions it has carried so far today (UTC).
tvl_usdnumber- Total value locked on the chain in US dollars, where tracked.
Example output
{
"average_block_time_seconds": 12.0,
"chain_id": "1",
"coin_price_change_percentage": -0.4,
"coin_price_usd": 2692.73,
"gas_average_gwei": 0.46,
"gas_fast_gwei": 2.0,
"gas_prices_updated_at": "2026-10-06T06:23:11Z",
"gas_slow_gwei": 0.22,
"gas_used_today": 216954643972,
"market_cap_usd": 328810430815.87,
"network_utilization_percentage": 48.06,
"total_addresses": 736874757,
"total_blocks": 26131032,
"total_transactions": 3786792527,
"transactions_today": 1771833,
"tvl_usd": null
}Get daily transaction counts
Get how many transactions a chain carried on each of the last thirty days, oldest first - the series behind the activity chart on the explorer's front page, ready for a chart or a week-over-week comparison.
Inputs
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many days were returned.
dayslist- One entry per day, oldest first.
Example output
{
"chain_id": "1",
"count": 2,
"days": [
{
"date": "2026-10-04",
"transactions_count": 1812390
},
{
"date": "2026-10-05",
"transactions_count": 1771833
}
]
}Get gas prices
Get the gas prices a chain is asking right now, in gwei, for a slow, an average and a fast transaction - the numbers behind the gas tracker on the explorer. Poll it on a schedule to alert when gas drops below a threshold, or to hold a transaction back until the chain is cheap.
Inputs
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
average_gweinumber- The price for an average one, in gwei.
chain_idtext- The chain the call was made against, as its chain id.
fast_gweinumber- The price for a fast one, in gwei.
next_update_in_secondsnumber- How many seconds until Blockscout refreshes them.
slow_gweinumber- The price to pay for a slow transaction, in gwei.
updated_attext- When the prices were last refreshed, as a UTC date and time (2026-10-06T04:01:11Z).
updated_at_unixnumber- When the prices were last refreshed, as unix seconds.
Example output
{
"average_gwei": 0.46,
"chain_id": "1",
"fast_gwei": 2.0,
"next_update_in_seconds": 13,
"slow_gwei": 0.22,
"updated_at": "2026-10-06T06:23:11Z",
"updated_at_unix": 1791267791
}Get the native coin's price history
Get the native coin's closing price and market cap in US dollars for each of the last thirty days, oldest first, plus its available supply. Where the chain's total value locked is tracked, that comes too.
Inputs
- Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
available_supplynumber- The coin's circulating supply, in whole coins.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many days were returned.
dayslist- One entry per day, oldest first.
Example output
{
"available_supply": 122110434.69,
"chain_id": "1",
"count": 2,
"days": [
{
"closing_price_usd": 2703.55,
"date": "2026-10-04",
"market_cap_usd": 330131221845.12,
"tvl_usd": null
},
{
"closing_price_usd": 2692.73,
"date": "2026-10-05",
"market_cap_usd": 328810430815.87,
"tvl_usd": null
}
]
}List a block's transactions
List the transactions a block confirmed, in the order they were mined, each with its value, fee, status and decoded method. Name the block by number or by hash.
Inputs
- Block
blocktextRequired - The block number, or its 66-character hash.
- How many
limitnumber - How many transactions to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
blocktext- The block that was listed, as given.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
transactionslist- The block's transactions, first mined first.
Example output
{
"block": "26128184",
"chain_id": "1",
"count": 1,
"has_more": true,
"transactions": [
{
"base_fee_per_gas": 602463848,
"base_fee_per_gas_gwei": "0.602463848",
"block_number": 26128184,
"burnt_fee": 12689073557676,
"burnt_fee_units": "0.000012689073557676",
"confirmations": 3347,
"created_contract": null,
"decoded_parameters": [],
"fee": 12689073557676,
"fee_units": "0.000012689073557676",
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"gas_limit": 21062,
"gas_price": 602463848,
"gas_price_gwei": "0.602463848",
"gas_used": 21062,
"has_error_in_internal_transactions": false,
"hash": "0x337ee39459dd802c05f566ff8c1898bb99703eb307594cbd2e5d2945af85ff7a",
"max_fee_per_gas": 3204925796,
"max_fee_per_gas_gwei": "3.204925796",
"max_priority_fee_per_gas": 2000000000,
"max_priority_fee_per_gas_gwei": "2",
"method": null,
"method_call": null,
"nonce": 14,
"position": 103,
"result": "success",
"revert_reason": null,
"status": "success",
"success": true,
"timestamp": "2026-10-05T19:13:11Z",
"timestamp_unix": 1791227591,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token_transfers_count": 0,
"transaction_types": [
"coin_transfer"
],
"type": 2,
"value": 3690640000000000,
"value_units": "0.00369064"
}
]
}List a contract's event logs
List the events a contract emitted, newest first, each decoded against its ABI when Blockscout knows it - so a Transfer arrives with its from, to and value as named fields rather than as hex topics. Give a topic to keep only one kind of event.
Inputs
- Contract address
addresstextRequired - The address of the contract.
- Topic
topictext - Only events carrying this 32-byte topic - usually the event signature hash, such as Transfer's 0xddf252ad...b3ef. Leave blank for every event.
- How many
limitnumber - How many events to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
logslist- The events, newest first.
Example output
{
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"chain_id": "1",
"count": 1,
"has_more": true,
"logs": [
{
"address": {
"ens_name": null,
"hash": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"implementation_address": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
"implementation_name": "FiatTokenV2_2",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "FiatTokenProxy",
"name": "FiatTokenProxy",
"proxy_type": "eip1967",
"tags": [
"Circle: USDC Token"
]
},
"block_number": 26130811,
"data": "0x00000000000000000000000000000000000000000000000000000000017d7840",
"event": "Transfer(address indexed from, address indexed to, uint256 value)",
"event_signature_hash": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"index": 703,
"parameters": [
{
"name": "from",
"type": "address",
"value": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624"
},
{
"name": "to",
"type": "address",
"value": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"name": "value",
"type": "uint256",
"value": "25000000"
}
],
"timestamp": "2026-10-06T04:01:11Z",
"timestamp_unix": 1791259271,
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000d47a1bdc6872ad2fd16e50149baa9924c653e624",
"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
],
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9"
}
]
}List a token's holders
List the addresses holding the most of a token, largest first, each with its holding in raw and whole units, its share of the supply, and the name Blockscout knows the holder by - an exchange, a pool, a treasury.
Inputs
- Token contract address
token_addresstextRequired - The token's contract address.
- How many
limitnumber - How many holders to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
holderslist- The holders, largest first.
tokenobject- A token, as Blockscout describes it.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": true,
"holders": [
{
"address": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"share_percent": 0.001102,
"value": 487590403130,
"value_units": "487590.40313"
}
],
"token": {
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
}
}List a token's transfers
List the latest transfers of one token, newest first - who sent how much to whom, in raw and whole units, and in which transaction. For an NFT collection, which token ids moved.
Inputs
- Token contract address
token_addresstextRequired - The token's contract address.
- How many
limitnumber - How many transfers to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
token_addresstext- A 42-character address, lowercased.
transferslist- The transfers, newest first.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": true,
"token_address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"transfers": [
{
"amount": 25000000,
"amount_units": "25",
"block_number": 26130811,
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"log_index": 703,
"method": "transfer",
"timestamp": "2026-10-06T04:01:11Z",
"timestamp_unix": 1791259271,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token": {
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
},
"token_id": null,
"token_type": "ERC-20",
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9"
}
]
}List a transaction's event logs
List the events one transaction emitted, each decoded against the emitting contract's ABI when Blockscout knows it, so an Approval or a Swap arrives with named fields. The raw topics and data are kept alongside for anything undecoded.
Inputs
- Transaction hash
transaction_hashtextRequired - The 66-character transaction hash, starting with 0x.
- How many
limitnumber - How many events to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
logslist- The events, in the order they were emitted.
transaction_hashtext- A 66-character hash.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": false,
"logs": [
{
"address": {
"ens_name": null,
"hash": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"implementation_address": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
"implementation_name": "FiatTokenV2_2",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "FiatTokenProxy",
"name": "FiatTokenProxy",
"proxy_type": "eip1967",
"tags": [
"Circle: USDC Token"
]
},
"block_number": 26130811,
"data": "0x00000000000000000000000000000000000000000000000000000000017d7840",
"event": "Transfer(address indexed from, address indexed to, uint256 value)",
"event_signature_hash": "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"index": 703,
"parameters": [
{
"name": "from",
"type": "address",
"value": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624"
},
{
"name": "to",
"type": "address",
"value": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045"
},
{
"name": "value",
"type": "uint256",
"value": "25000000"
}
],
"timestamp": "2026-10-06T04:01:11Z",
"timestamp_unix": 1791259271,
"topics": [
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
"0x000000000000000000000000d47a1bdc6872ad2fd16e50149baa9924c653e624",
"0x000000000000000000000000d8da6bf26964af9d7eed9e03e53415d37aa96045"
],
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9"
}
],
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9"
}List a transaction's internal transactions
Break one transaction open and list every call and value move it set off inside contracts - the way to see where the money actually went in a multi-step contract call, and which inner call failed when one did.
Inputs
- Transaction hash
transaction_hashtextRequired - The 66-character transaction hash, starting with 0x.
- How many
limitnumber - How many internal transactions to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
internal_transactionslist- The internal transactions, in the order they ran.
transaction_hashtext- A 66-character hash.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": false,
"internal_transactions": [
{
"block_number": 26121325,
"created_contract": null,
"error": null,
"from": {
"ens_name": null,
"hash": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"implementation_address": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
"implementation_name": "FiatTokenV2_2",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "FiatTokenProxy",
"name": "FiatTokenProxy",
"proxy_type": "eip1967",
"tags": [
"Circle: USDC Token"
]
},
"gas_limit": 21308,
"index": 2,
"success": true,
"timestamp": "2026-10-04T20:16:47Z",
"timestamp_unix": 1791145007,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"transaction_hash": "0x9f0f5e6d4a1c6b1f2d3e4c5b6a798877665544332211aabbccddeeff00112233",
"type": "call",
"value": 50000000000000000,
"value_units": "0.05"
}
],
"transaction_hash": "0x9f0f5e6d4a1c6b1f2d3e4c5b6a798877665544332211aabbccddeeff00112233"
}List a transaction's token transfers
List every token that moved inside one transaction - each with the token's name, symbol and decimals, who sent it to whom, and the amount in raw and whole units. This is what shows what a swap actually swapped.
Inputs
- Transaction hash
transaction_hashtextRequired - The 66-character transaction hash, starting with 0x.
- How many
limitnumber - How many transfers to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
transaction_hashtext- A 66-character hash.
transferslist- The transfers, in the order they happened.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": false,
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9",
"transfers": [
{
"amount": 25000000,
"amount_units": "25",
"block_number": 26130811,
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"log_index": 703,
"method": "transfer",
"timestamp": "2026-10-06T04:01:11Z",
"timestamp_unix": 1791259271,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token": {
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
},
"token_id": null,
"token_type": "ERC-20",
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9"
}
]
}List an address's internal transactions
List the internal transactions that touched an address - the value moves a contract made on its own, which never appear in the normal transaction list. A withdrawal from an exchange contract or a DeFi position lands here, not under the address's transactions.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- Direction
directiontext - Only what the address received, only what it sent, or both. Both by default.One of:
any(Sent or received),to(Received only),from(Sent only). Default:any. - How many
limitnumber - How many internal transactions to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
internal_transactionslist- The internal transactions, newest first.
Example output
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain_id": "1",
"count": 1,
"has_more": true,
"internal_transactions": [
{
"block_number": 26121325,
"created_contract": null,
"error": null,
"from": {
"ens_name": null,
"hash": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"implementation_address": "0x43506849d7c04f9138d1a2050bbf3a0c054402dd",
"implementation_name": "FiatTokenV2_2",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "FiatTokenProxy",
"name": "FiatTokenProxy",
"proxy_type": "eip1967",
"tags": [
"Circle: USDC Token"
]
},
"gas_limit": 21308,
"index": 2,
"success": true,
"timestamp": "2026-10-04T20:16:47Z",
"timestamp_unix": 1791145007,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"transaction_hash": "0x9f0f5e6d4a1c6b1f2d3e4c5b6a798877665544332211aabbccddeeff00112233",
"type": "call",
"value": 50000000000000000,
"value_units": "0.05"
}
]
}List an address's NFTs
List the NFTs an address holds, each with its collection, token id, name, image and traits from its metadata - and, for an ERC-1155, how many of that token id it has. Narrow it to ERC-721 or ERC-1155.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- NFT standards
token_typestext - Only NFTs of these standards. Leave every box unticked for all of them.One or more of:
ERC-721(ERC-721 (NFTs)),ERC-1155(ERC-1155 (multi-token)),ERC-404. - How many
limitnumber - How many NFTs to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
nftslist- The NFTs the address holds.
Example output
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain_id": "1",
"count": 1,
"has_more": true,
"nfts": [
{
"animation_url": null,
"attributes": [
{
"display_type": null,
"trait": "generation",
"value": "0"
},
{
"display_type": null,
"trait": "fancy_type",
"value": "Genesis"
}
],
"description": null,
"external_url": null,
"image_url": "https://img.cryptokitties.co/0x06012c8cf97bead5deae237070f9587f8e7a266d/1.png",
"is_unique": true,
"media_type": null,
"media_url": "https://img.cryptokitties.co/0x06012c8cf97bead5deae237070f9587f8e7a266d/1.png",
"name": "Genesis",
"owner": null,
"quantity": 1,
"token": {
"address": "0x06012c8cf97bead5deae237070f9587f8e7a266d",
"decimals": null,
"holders_count": 112345,
"icon_url": null,
"is_bridged": null,
"market_cap_usd": null,
"name": "CryptoKitties",
"price_usd": null,
"reputation": "ok",
"symbol": "CK",
"total_supply": 2024521,
"total_supply_units": "2024521",
"type": "ERC-721",
"volume_24h_usd": null
},
"token_id": "1",
"token_type": "ERC-721"
}
]
}List an address's token balances
List every token an address holds, most valuable first, each with the token's name, symbol and price and the holding in raw units, whole tokens and US dollars - plus the portfolio's total in dollars. Narrow it to a standard to get only ERC-20 holdings, or only NFTs.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- Token standards
token_typestext - Only tokens of these standards. Leave every box unticked for all of them.One or more of:
ERC-20(ERC-20 (fungible tokens)),ERC-721(ERC-721 (NFTs)),ERC-1155(ERC-1155 (multi-token)),ERC-404. - How many
limitnumber - How many tokens to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
balanceslist- The holdings, most valuable first.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
total_value_usdnumber- What the priced holdings in this page add up to, in US dollars. Null when none of them has a price.
Example output
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"balances": [
{
"nft_name": null,
"token": {
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
},
"token_id": null,
"value": 1250000000,
"value_units": "1250",
"value_usd": 1249.9
}
],
"chain_id": "1",
"count": 1,
"has_more": true,
"total_value_usd": 1249.9
}List an address's token transfers
List the token transfers that touched an address, newest first - ERC-20 payments, NFTs changing hands, ERC-1155 quantities - each with the token's name, symbol and decimals and the amount in both raw and whole units. Narrow it to a standard, a direction, or one token's contract.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- Token standards
token_typestext - Only tokens of these standards. Leave every box unticked for all of them.One or more of:
ERC-20(ERC-20 (fungible tokens)),ERC-721(ERC-721 (NFTs)),ERC-1155(ERC-1155 (multi-token)),ERC-404. - Direction
directiontext - Only what the address received, only what it sent, or both. Both by default.One of:
any(Sent or received),to(Received only),from(Sent only). Default:any. - Token contract address
token_addresstext - Only transfers of this token. Leave blank for every token.
- How many
limitnumber - How many transfers to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
transferslist- The transfers, newest first.
Example output
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain_id": "1",
"count": 1,
"has_more": true,
"transfers": [
{
"amount": 25000000,
"amount_units": "25",
"block_number": 26130811,
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"log_index": 703,
"method": "transfer",
"timestamp": "2026-10-06T04:01:11Z",
"timestamp_unix": 1791259271,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token": {
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
},
"token_id": null,
"token_type": "ERC-20",
"transaction_hash": "0x53f109a88a180457eb8f558e73c02636f9a3ddb8d017f886a242dd2c4dc1a8e9"
}
]
}List an address's transactions
List the transactions an address sent or received, newest first, each with its value, fee, whether it succeeded, the method it called decoded by name, and who was on the other end - with their names and labels. Narrow it to what the address sent or what it received.
Inputs
- Address
addresstextRequired - The wallet or contract address to look at.
- Direction
directiontext - Only what the address received, only what it sent, or both. Both by default.One of:
any(Sent or received),to(Received only),from(Sent only). Default:any. - How many
limitnumber - How many transactions to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
addresstext- A 42-character address, lowercased.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
transactionslist- The transactions, newest first.
Example output
{
"address": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"chain_id": "1",
"count": 1,
"has_more": true,
"transactions": [
{
"base_fee_per_gas": 602463848,
"base_fee_per_gas_gwei": "0.602463848",
"block_number": 26128184,
"burnt_fee": 12689073557676,
"burnt_fee_units": "0.000012689073557676",
"confirmations": 3347,
"created_contract": null,
"decoded_parameters": [],
"fee": 12689073557676,
"fee_units": "0.000012689073557676",
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"gas_limit": 21062,
"gas_price": 602463848,
"gas_price_gwei": "0.602463848",
"gas_used": 21062,
"has_error_in_internal_transactions": false,
"hash": "0x337ee39459dd802c05f566ff8c1898bb99703eb307594cbd2e5d2945af85ff7a",
"max_fee_per_gas": 3204925796,
"max_fee_per_gas_gwei": "3.204925796",
"max_priority_fee_per_gas": 2000000000,
"max_priority_fee_per_gas_gwei": "2",
"method": null,
"method_call": null,
"nonce": 14,
"position": 103,
"result": "success",
"revert_reason": null,
"status": "success",
"success": true,
"timestamp": "2026-10-05T19:13:11Z",
"timestamp_unix": 1791227591,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token_transfers_count": 0,
"transaction_types": [
"coin_transfer"
],
"type": 2,
"value": 3690640000000000,
"value_units": "0.00369064"
}
]
}List recent blocks
List the most recently mined blocks, newest first, with when each was mined, who produced it, what is in it and how full it was. Switch to uncle blocks or to blocks dropped in a reorganisation to see those instead.
Inputs
- Kind of block
block_typetext - Which blocks to list. Main-chain blocks by default.One of:
block(Blocks in the main chain),uncle(Uncle blocks (pre-Merge Ethereum only)),reorg(Blocks dropped in a reorganisation). Default:block. - How many
limitnumber - How many blocks to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
block_typetext- Which kind was listed: block, uncle or reorg.
blockslist- The blocks, newest first.
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
Example output
{
"block_type": "block",
"blocks": [
{
"base_fee_per_gas": 602463848,
"base_fee_per_gas_gwei": "0.602463848",
"burnt_fees": 13167593573480016,
"burnt_fees_units": "0.013167593573480016",
"difficulty": 0,
"gas_limit": 45000000,
"gas_target_percentage": -2.86,
"gas_used": 21856422,
"gas_used_percentage": 48.57,
"hash": "0xbead83234625054fe1f58d54d57f3ed76980a9cc320f22d6e2a8e6a512748f69",
"height": 26128184,
"internal_transactions_count": 82,
"miner": {
"ens_name": null,
"hash": "0x95222290dd7278aa3ddd389cc1e1d165cc4bafe5",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": "beaverbuild",
"name": null,
"proxy_type": null,
"tags": [
"beaverbuild"
]
},
"nonce": "0x0000000000000000",
"parent_hash": "0x598d814e2b417168410c102175e5ea90ae5cd787e4798aac0db47062d7464436",
"priority_fee": 2118838534209984,
"priority_fee_units": "0.002118838534209984",
"rewards": [
{
"reward": 2118838534209984,
"reward_units": "0.002118838534209984",
"type": "Validator Reward"
}
],
"size": 87639,
"timestamp": "2026-10-05T19:13:11Z",
"timestamp_unix": 1791227591,
"transaction_fees": 15286432107690000,
"transaction_fees_units": "0.01528643210769",
"transactions_count": 163,
"type": "block",
"uncles_count": 0,
"withdrawals_count": 16
}
],
"chain_id": "1",
"count": 1,
"has_more": true
}List recent transactions
List the latest transactions on a chain, newest first - the live feed on the explorer's front page - or the ones still waiting to be mined. A sample of what is going on right now.
Inputs
- Which
statustext - Confirmed transactions, or the ones still pending. Confirmed by default.One of:
validated(Confirmed transactions),pending(Pending transactions). Default:validated. - How many
limitnumber - How many transactions to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
statustext- Which were listed: validated or pending.
transactionslist- The transactions, newest first.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": true,
"status": "validated",
"transactions": [
{
"base_fee_per_gas": 602463848,
"base_fee_per_gas_gwei": "0.602463848",
"block_number": 26128184,
"burnt_fee": 12689073557676,
"burnt_fee_units": "0.000012689073557676",
"confirmations": 3347,
"created_contract": null,
"decoded_parameters": [],
"fee": 12689073557676,
"fee_units": "0.000012689073557676",
"from": {
"ens_name": null,
"hash": "0xd47a1bdc6872ad2fd16e50149baa9924c653e624",
"implementation_address": null,
"implementation_name": null,
"is_contract": false,
"is_scam": false,
"is_verified": false,
"label": null,
"name": null,
"proxy_type": null,
"tags": []
},
"gas_limit": 21062,
"gas_price": 602463848,
"gas_price_gwei": "0.602463848",
"gas_used": 21062,
"has_error_in_internal_transactions": false,
"hash": "0x337ee39459dd802c05f566ff8c1898bb99703eb307594cbd2e5d2945af85ff7a",
"max_fee_per_gas": 3204925796,
"max_fee_per_gas_gwei": "3.204925796",
"max_priority_fee_per_gas": 2000000000,
"max_priority_fee_per_gas_gwei": "2",
"method": null,
"method_call": null,
"nonce": 14,
"position": 103,
"result": "success",
"revert_reason": null,
"status": "success",
"success": true,
"timestamp": "2026-10-05T19:13:11Z",
"timestamp_unix": 1791227591,
"to": {
"ens_name": "vitalik.eth",
"hash": "0xd8da6bf26964af9d7eed9e03e53415d37aa96045",
"implementation_address": "0x5a7fc11397e9a8ad41bf10bf13f22b0a63f96f6d",
"implementation_name": "AmbireAccount7702",
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "vitalik.eth",
"name": null,
"proxy_type": "eip7702",
"tags": [
"Vitalik Buterin"
]
},
"token_transfers_count": 0,
"transaction_types": [
"coin_transfer"
],
"type": 2,
"value": 3690640000000000,
"value_units": "0.00369064"
}
]
}List supported chains
List every chain the Blockscout PRO API covers - Ethereum, Optimism, Base, Arbitrum, Polygon, Gnosis, zkSync and a hundred more, testnets included - with each one's chain id, native coin and explorer, and whether it needs a paid plan. The chain id is what every other action's Chain field holds. Needs no credits: the list is public.
Inputs
- Include testnets
include_testnetstrue/false - Whether to list test networks alongside the mainnets. Yes by default.Default:
true.
Outputs
chainslist- The chains, Ethereum first, then mainnets by name, then testnets by name.
countnumber- How many chains were listed.
mainnet_countnumber- How many of them are mainnets.
testnet_countnumber- How many of them are testnets.
Example output
{
"chains": [
{
"chain_id": "1",
"description": "Decentralized global computing platform supporting smart contracts & P2P apps.",
"ecosystem": "Ethereum",
"explorer_url": "https://eth.blockscout.com",
"is_testnet": false,
"layer": 1,
"logo_url": "https://blockscout-icons.s3.us-east-1.amazonaws.com/ethereum.svg",
"name": "Ethereum",
"native_currency": "ETH",
"requires_paid_plan": false,
"rollup_type": null,
"website": "https://ethereum.org/"
},
{
"chain_id": "8453",
"description": "Base is a secure, low-cost, builder-friendly Ethereum L2 built to bring the next billion users onchain.",
"ecosystem": "Ethereum, Superchain",
"explorer_url": "https://base.blockscout.com",
"is_testnet": false,
"layer": 2,
"logo_url": "https://blockscout-icons.s3.us-east-1.amazonaws.com/base.svg",
"name": "Base",
"native_currency": "ETH",
"requires_paid_plan": true,
"rollup_type": "optimistic",
"website": "https://base.org/"
}
],
"count": 2,
"mainnet_count": 2,
"testnet_count": 0
}List the richest addresses
List the addresses holding the most of a chain's native coin, largest first, each with its balance in coins and US dollars, its transaction count and the name Blockscout knows it by - an exchange, a bridge, a staking contract. Rank by transaction count instead to find the busiest addresses.
Inputs
- Rank by
sorttext - Rank by balance, or by how many transactions each has made.One of:
balance,transactions_count(Transaction count). Default:balance. - Order
ordertext - Largest first, or smallest first.One of:
desc(Largest first),asc(Smallest first). Default:desc. - How many
limitnumber - How many addresses to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
accountslist- The addresses, in the order asked for.
chain_idtext- The chain the call was made against, as its chain id.
coin_price_usdnumber- The native coin's price in US dollars the balances were valued at.
coin_total_supplynumber- The coin's total supply, in whole coins.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
Example output
{
"accounts": [
{
"balance": 68950642000000000000000000,
"balance_units": "68950642",
"balance_usd": 185669560000.0,
"ens_name": null,
"hash": "0x00000000219ab540356cbb839cbe05303d7705fa",
"implementation_address": null,
"implementation_name": null,
"is_contract": true,
"is_scam": false,
"is_verified": true,
"label": "Beacon Deposit Contract",
"name": "DepositContract",
"proxy_type": null,
"tags": [
"Beacon Deposit Contract"
],
"transactions_count": 2187493
}
],
"chain_id": "1",
"coin_price_usd": 2692.73,
"coin_total_supply": 122110434.694854,
"count": 1,
"has_more": true
}Search a chain
Search a chain the way the explorer's search box does: by a token or contract name, an ENS name, a public label, or a partial address, hash or block number. Each result says what it is - token, contract, address, block, transaction, ENS domain - and carries the address or hash the other actions take.
Inputs
- Search for
querytextRequired - A name, symbol, label, ENS name, address, hash or block number, whole or in part.
- How many
limitnumber - How many results to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
querytext- What was searched for.
resultslist- The results, best match first.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": false,
"query": "USDC",
"results": [
{
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"block_hash": null,
"block_number": null,
"ens_name": null,
"explorer_path": "/token/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_verified_contract": true,
"name": "USD Coin",
"symbol": "USDC",
"token_type": "ERC-20",
"transaction_hash": null,
"type": "token"
}
]
}Search tokens
Find tokens on a chain by name or symbol, most held first, each with its contract address, standard, decimals, holder count and price - the way to turn 'USDC on Base' into the contract address the other token actions take.
Inputs
- Name or symbol
querytextRequired - Part of the token's name or symbol.
- Token standards
token_typestext - Only tokens of these standards. Leave every box unticked for all of them.One or more of:
ERC-20(ERC-20 (fungible tokens)),ERC-721(ERC-721 (NFTs)),ERC-1155(ERC-1155 (multi-token)),ERC-404. - How many
limitnumber - How many tokens to return, newest first, at most 100. 25 by default.From 1 to 100. Default:
25. - Chain
chain_idtext - Which chain to query. Leave blank for Ethereum mainnet. Pick from the list of chains the PRO API covers - Optimism, Arbitrum, Gnosis, Scroll and a hundred more - or type a chain id. Base, Polygon and zkSync need a paid plan since 1 October 2026; the free plan covers the rest.Default:
1.
Outputs
chain_idtext- The chain the call was made against, as its chain id.
countnumber- How many records this step returned.
has_moretrue/false- Whether more records were left than the step was asked for.
querytext- What was searched for.
tokenslist- The matching tokens, most held first.
Example output
{
"chain_id": "1",
"count": 1,
"has_more": true,
"query": "USDC",
"tokens": [
{
"address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
"decimals": 6,
"holders_count": 3417026,
"icon_url": "https://assets.coingecko.com/coins/images/6319/small/usdc.png",
"is_bridged": false,
"market_cap_usd": 74235990234.42789,
"name": "USD Coin",
"price_usd": 0.999921,
"reputation": "ok",
"symbol": "USDC",
"total_supply": 44233567890123456,
"total_supply_units": "44233567890.123456",
"type": "ERC-20",
"volume_24h_usd": 17584880940.073784
}
]
}