# Blockchain Scanner

> 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.

- Skill: `agentpmt/blockchain-scanner` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add agentpmt/blockchain-scanner`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agentpmt/blockchain-scanner/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: AgentPMT (https://skillmd.com/u/agentpmt)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/agentpmt/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 Value | Network |
|---|---|
| `ethereum` | Ethereum Mainnet (default) |
| `base` | Base L2 |
| `base_sepolia` | Base Sepolia Testnet |
| `polygon` | Polygon PoS |
| `arbitrum` | Arbitrum One |
| `optimism` | Optimism 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