etherscan

Etherscan is a block explorer and API platform for Ethereum and supported EVM networks. It provides transaction details, wallet histories, token transfers, verified contract source code, and contract ABIs.

In Agent Forge, the Etherscan integration allows workflows to retrieve Ethereum on-chain data directly from Etherscan APIs. Use it for transaction monitoring, wallet analysis, token transfer reporting, contract inspection, and agent-powered blockchain research.

Usage Instructions

Provide an Etherscan API key, select an operation, and pass the required transaction hash, wallet address, or contract address. Advanced fields allow you to set chain ID, block ranges, pagination, result size, and sort order.

Tools

etherscan_get_tx

Fetch transaction details by transaction hash.

etherscan_get_address_txs

Retrieve normal transactions for a wallet address.

etherscan_get_token_txs

Retrieve token transfer events for an address, optionally filtered by contract address.

etherscan_get_contract_source

Fetch verified contract source code and metadata.

etherscan_get_contract_abi

Fetch the verified ABI for a contract address.

Common Inputs

Parameter	Type	Required	Description
apiKey	string	Yes	Etherscan API key
txHash	string	Operation-specific	Transaction hash
address	string	Operation-specific	Wallet address
contractAddress	string	Operation-specific	Contract address
chainId	number	No	EVM chain ID, defaulting to Ethereum mainnet
startBlock	number	No	Starting block number
endBlock	number	No	Ending block number
page	number	No	Page number
offset	number	No	Results per page
sort	string	No	Sort direction, asc or desc

Output

Parameter	Type	Description
data	json	Full Etherscan response data
status	string	Etherscan status value
message	string	Etherscan response message
result	json	Etherscan result payload

Notes

• Category: tools

• Type: etherscan