ClawHub

Blockchain Scanner

Workflows

Blockchain Scanner: Query EVM blockchain data: balances (up to 20 addresses), transactions, gas prices, contract ABIs. Supports Ethereum, Polygon, Base, Arbitrum, Optimism. Use when an agent needs blockchain scanner, blockchain transaction history & activity tracking, ethereum gas price & fee management, smart contract development, crypto balance & account management, balance, address, chain through AgentPMT-hosted remote tool calls. Discovery terms: blockchain scanner.

Install

openclaw skills install blockchain-scanner

Blockchain Scanner

Freshness

Last updated: 2026-06-10.

If the current date is more than 7 days after the last updated date, reinstall this skill from skills.sh or ClawHub before relying on endpoints, schemas, setup steps, or examples.

What This Tool Does

Multi-chain EVM blockchain data service providing four operations:

Balance – Get native currency balance (ETH, MATIC, etc.) for up to 20 addresses. Returns wei and standard units. Transactions – Paginated transaction history (100 per request). Includes hash, block, timestamp, addresses, value, gas metrics, input data, errors. Gas Oracle – EIP-1559 gas recommendations: base fee + priority fees for slow/standard/fast confirmation speeds. Contract ABI – Retrieve ABI JSON for verified smart contracts (functions, events, inputs/outputs).

Supported Networks: Ethereum, Base, Base Sepolia, Polygon, Arbitrum One, Optimism

Product Instructions

Blockchain Scanner

Multi-chain blockchain data retrieval tool. Query native token balances, ERC-20 token balances, transaction history, verified contract ABIs, and current gas prices across six supported networks.

Supported Chains

Chain ValueNetwork
ethereumEthereum Mainnet (default)
baseBase L2
base_sepoliaBase Sepolia Testnet
polygonPolygon PoS
arbitrumArbitrum One
optimismOptimism Mainnet

Actions

balance

Get the native token balance (ETH or MATIC) for one or more wallet addresses.

Required fields:

  • action: "balance"
  • address: Array of 1-20 wallet addresses (0x-prefixed, 42-character hex strings)

Optional fields:

  • chain: Network to query (default: "ethereum")

Example - Single address on Ethereum:

{
  "action": "balance",
  "address": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]
}

Example - Multiple addresses on Polygon:

{
  "action": "balance",
  "chain": "polygon",
  "address": [
    "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045",
    "0xAb5801a7D398351b8bE11C439e05C5B3259aeC9B"
  ]
}

Response includes: Each address with its balance in native units and in wei, the chain name, and the native token symbol (ETH or MATIC for Polygon).

token_balance

Get ERC-20 token balances for one or more wallet addresses. Supports major stablecoins and wrapped tokens.

Required fields:

  • action: "token_balance"
  • address: Array of 1-20 wallet addresses

Optional fields:

  • chain: Network to query (default: "ethereum")
  • token: Token symbol to query (e.g., "USDC", "USDT", "DAI", "WETH", "PYUSD"). Use "all" to query all supported tokens on the chain. Defaults to "all" if omitted.

Supported tokens by chain:

  • Ethereum: USDC, USDT, PYUSD, DAI, WETH, WBTC
  • Base: USDC, USDbC, DAI, WETH
  • Polygon: USDC, USDC.e, USDT, DAI, WETH, WMATIC
  • Arbitrum: USDC, USDC.e, USDT, DAI, WETH
  • Optimism: USDC, USDC.e, USDT, DAI, WETH

Example - Get USDC balance on Ethereum:

{
  "action": "token_balance",
  "address": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],
  "token": "USDC"
}

Example - Get all token balances on Base:

{
  "action": "token_balance",
  "chain": "base",
  "address": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],
  "token": "all"
}

Response includes: Each address with token balances (formatted balance, raw balance, decimals) for the requested tokens.

transactions

Get transaction history for a single address. Returns transactions sorted by most recent first, in pages of exactly 100.

Required fields:

  • action: "transactions"
  • address: Array with exactly 1 wallet address

Optional fields:

  • chain: Network to query (default: "ethereum")
  • transaction_range: Array of two integers [start, end] defining which 100-transaction window to fetch. Index 1 is the most recent transaction. Must span exactly 100 items. Default: [1, 100].

Example - Most recent 100 transactions:

{
  "action": "transactions",
  "address": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"]
}

Example - Transactions 101-200 on Arbitrum:

{
  "action": "transactions",
  "chain": "arbitrum",
  "address": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"],
  "transaction_range": [101, 200]
}

Response includes: Each transaction with hash, block number, timestamp, from/to addresses, value in ETH and wei, gas details, input data, and error status.

contract_abi

Retrieve the ABI (Application Binary Interface) for a verified smart contract.

Required fields:

  • action: "contract_abi"
  • address: Array with exactly 1 contract address

Optional fields:

  • chain: Network to query (default: "ethereum")

Example - Get ABI for a contract on Ethereum:

{
  "action": "contract_abi",
  "address": ["0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"]
}

Example - Get ABI on Optimism:

{
  "action": "contract_abi",
  "chain": "optimism",
  "address": ["0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"]
}

Response includes: The full ABI array, plus counts of functions and events in the contract.

gas_oracle

Get current gas price estimates for a blockchain network. Returns safe (slow), standard, and fast gas prices.

Required fields:

  • action: "gas_oracle"

Optional fields:

  • chain: Network to query (default: "ethereum")

Example - Ethereum gas prices:

{
  "action": "gas_oracle"
}

Example - Polygon gas prices:

{
  "action": "gas_oracle",
  "chain": "polygon"
}

Response includes: Safe, standard, and fast gas price estimates (in Gwei), suggested base fee, gas used ratio, and timestamp.

Common Workflows

Check a wallet's full portfolio
  1. Call balance to get native ETH/MATIC balance
  2. Call token_balance with token: "all" to get all ERC-20 holdings
Investigate transaction activity
  1. Call transactions with default range [1, 100] for the latest 100 transactions
  2. Page through older transactions with [101, 200], [201, 300], etc.
Inspect a smart contract
  1. Call contract_abi to retrieve the verified ABI
  2. Use the ABI to understand available functions and events
Estimate transaction costs
  1. Call gas_oracle to get current gas prices on the target chain

Important Notes

  • All addresses must be 0x-prefixed, 42-character hexadecimal strings.
  • The balance and token_balance actions accept up to 20 addresses per request.
  • The transactions and contract_abi actions require exactly 1 address.
  • The gas_oracle action does not require any address.
  • The transaction_range must always span exactly 100 transactions (e.g., [1, 100], [101, 200]).
  • On Polygon, the native token is MATIC; on all other chains it is ETH.
  • The contract_abi action only works for verified contracts. Unverified contracts will return an error.
  • Token availability varies by chain. If a token is not supported on the selected chain, the tool returns an error listing available tokens.
  • Base Sepolia (testnet) has no preconfigured ERC-20 tokens for token_balance.

When To Use

  • Use this skill for Blockchain Scanner on AgentPMT.
  • Use it when an agent needs this specific tool's behavior, schema, inputs, outputs, and invocation shape.
  • Search and activation keywords: blockchain scanner, blockchain transaction history & activity tracking, ethereum gas price & fee management, smart contract development, crypto balance & account management, balance, address, chain.
  • Supported action names: balance, contract_abi, gas_oracle, token_balance, transactions.

Use Cases

  • Blockchain Transaction History & Activity Tracking
  • Ethereum Gas Price & Fee Management
  • Smart Contract Development
  • Crypto Balance & Account Management
  • Multi-Chain & Cross-Chain Operations
  • Web3 Developer & Integration Tools

Categories And Industries

No categories or industry tags are published for this tool.

Actions And Schema

Complete generated action schema: ./schema.md. Supported action count: 5. x402 availability: not enabled for this product.

  • balance (action slug: balance): Get native token balance (ETH or MATIC) for one or more wallet addresses. Returns balance in both native units and wei. Price: 5 credits. Parameters: address, chain.
  • contract_abi (action slug: contract-abi): Retrieve the ABI (Application Binary Interface) JSON for a verified smart contract. Returns the full ABI array plus counts of functions and events. Price: 5 credits. Parameters: address, chain.
  • gas_oracle (action slug: gas-oracle): Get current gas price estimates (safe/standard/fast) for a blockchain network. Returns prices in Gwei with EIP-1559 base fee suggestions. Price: 5 credits. Parameters: chain.
  • token_balance (action slug: token-balance): Get ERC-20 token balances for one or more wallet addresses. Supports major stablecoins and wrapped tokens across all supported chains. Price: 5 credits. Parameters: address, chain, token.
  • transactions (action slug: transactions): Get paginated transaction history for a single address. Returns 100 transactions per request sorted by most recent first. Price: 5 credits. Parameters: address, chain, transaction_range.

Live Schema And Examples

Use the compact schema above for ordinary calls. Before a new production integration, or whenever parameters, enum values, nested objects, outputs, or examples are unclear, fetch live details first.

  • Exact schema: call agentpmt-tool-search-and-execution with action: "get_schema", and tool_id: "blockchain-scanner".
  • Detailed examples: call agentpmt-tool-search-and-execution with action: "get_instructions" and tool_id: "blockchain-scanner", or call this product with action: "get_instructions" when the product tool is already selected.
  • Treat returned live schema and instructions as more specific than this generated summary.

MCP schema lookup through the main AgentPMT MCP server:

{
  "method": "tools/call",
  "params": {
    "name": "AgentPMT-Tool-Search-and-Execution",
    "arguments": {
      "action": "get_schema",
      "tool_id": "blockchain-scanner"
    }
  }
}

For live examples, keep the same MCP tool and use these arguments:

{
  "action": "get_instructions",
  "tool_id": "blockchain-scanner"
}

Authenticated AgentPMT REST schema lookup body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_schema",
    "tool_id": "blockchain-scanner"
  }
}

Authenticated AgentPMT REST live examples body:

{
  "name": "agentpmt-tool-search-and-execution",
  "parameters": {
    "action": "get_instructions",
    "tool_id": "blockchain-scanner"
  }
}

Call This Tool

Product slug: blockchain-scanner

Marketplace page: https://www.agentpmt.com/marketplace/blockchain-scanner

  • AgentPMT account route: first use ../agentpmt-account-mcp-rest-api-setup to connect the main MCP server or REST API for an Agent Group where this tool is enabled.
  • x402 route: not enabled for this product.
  • AgentPMT overview: use ../what-is-agentpmt for marketplace, Agent Group, workflow, MCP, REST, and payment concepts.

If those setup skills are not installed beside this product skill, use the downloads below.

Core AgentPMT setup skills:

  • What AgentPMT is: ../what-is-agentpmt
  • AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup

skills.sh install script:

npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

MCP call shape after the main AgentPMT MCP server is connected:

{
  "method": "tools/call",
  "params": {
    "name": "Blockchain-Scanner",
    "arguments": {
      "action": "balance",
      "address": [
        "example addre"
      ],
      "chain": "ethereum"
    }
  }
}

Use the exact tool name returned by tools/list; the name above is the expected readable form.

Authenticated AgentPMT REST call body:

{
  "name": "blockchain-scanner",
  "parameters": {
    "action": "balance",
    "address": [
      "example addre"
    ],
    "chain": "ethereum"
  }
}

Use the setup skill for the account connection details before making REST calls.

Response Handling

  • Treat the returned JSON as the source of truth for this tool call.
  • If the response includes warnings or correction targets, apply them before retrying.
  • If the response includes a passed or success-style boolean, use it as the workflow gate.
  • If validation fails or the response shape is unclear, call get_schema or get_instructions before retrying.
  • If balance fails, preserve the request parameters and retry only after fixing schema, auth, or payment errors.

Security

  • Do not place account secrets, wallet private keys, mnemonics, signatures, or payment headers in prompts or logs.
  • Keep tool inputs scoped to the minimum content needed for the task.
  • Use the setup skills for credential handling; this product skill only defines product-specific behavior.

AgentPMT Reference

More in Workflows