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 ValueNetworkethereumEthereum Mainnet (default)baseBase L2base_sepoliaBase Sepolia TestnetpolygonPolygon PoSarbitrumArbitrum OneoptimismOptimism 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:

json

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

Example - Multiple addresses on Polygon:

json

{
  "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:

json

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

Example - Get all token balances on Base:

json

{
  "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:

json

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

Example - Transactions 101-200 on Arbitrum:

json

{
  "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:

json

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

Example - Get ABI on Optimism:

json

{
  "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:

json

{
  "action": "gas_oracle"
}

Example - Polygon gas prices:

json

{
  "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:

json

{
  "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:

json

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

Authenticated AgentPMT REST schema lookup body:

json

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

Authenticated AgentPMT REST live examples body:

json

{
  "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
  • ClawHub page: https://clawhub.ai/agentpmt/what-is-agentpmt
  • OpenClaw install: openclaw skills install what-is-agentpmt
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup
  • ClawHub page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup
  • OpenClaw install: openclaw skills install agentpmt-account-mcp-rest-api-setup
  • skills.sh install: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup

skills.sh install script:

bash

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:

json

{
  "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:

json

{
  "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#

• What AgentPMT is: ../what-is-agentpmt (ClawHub: what-is-agentpmt, page: https://clawhub.ai/agentpmt/what-is-agentpmt; skills.sh: npx skills add AgentPMT/agent-skills --skill what-is-agentpmt)
• AgentPMT account MCP/REST setup: ../agentpmt-account-mcp-rest-api-setup (ClawHub: agentpmt-account-mcp-rest-api-setup, page: https://clawhub.ai/agentpmt/agentpmt-account-mcp-rest-api-setup; skills.sh: npx skills add AgentPMT/agent-skills --skill agentpmt-account-mcp-rest-api-setup)
• Marketplace product: https://www.agentpmt.com/marketplace/blockchain-scanner
• AgentPMT main MCP server: https://api.agentpmt.com/mcp/
• AgentPMT REST invoke endpoint: https://api.agentpmt.com/products/purchase