Blockchain Scanner

Available ActionsEach successful request consumes credits as outlined below.

balance^5crtoken_balance^5crtransactions^5crcontract_abi^5crgas_oracle^5cr

Details

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

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

Connect Your Agent In 5 Min

Watch the setup guide for your platform

Or Install Locally

STDIO connector for Claude Code, Codex, Cursor, Zed, and other LLMs that require STDIO or custom connections. This lightweight connector routes requests to https://api.agentpmt.com/mcp. All tool execution happens in the cloud and the server cannot edit any files on your computer.

npm install -g @agentpmt/mcp-routeragentpmt-setup

curl -X POST "https://api.agentpmt.com/products/purchase" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ********" \
  -d '{
    "product_id": "694832d8b54506f955d789e7",
    "parameters": {
      "action": "balance",
      "address": []
    }
  }'

import requests
import json

url = "https://api.agentpmt.com/products/purchase"

headers = {
    "Content-Type": "application/json",
    "Authorization": "Bearer ********"
}

data = {
    "product_id": "694832d8b54506f955d789e7",
    "parameters": {
        "action": "balance",
        "address": []
    }
}

response = requests.post(url, headers=headers, json=data)
print(response.status_code)
print(response.json())

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "694832d8b54506f955d789e7",
  parameters: {
    "action": "balance",
    "address": []
  }
};

fetch(url, {
  method: "POST",
  headers,
  body: JSON.stringify(data)
})
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error("Error:", error));

const axios = require('axios');

const url = "https://api.agentpmt.com/products/purchase";

const headers = {
  "Content-Type": "application/json",
  "Authorization": "Bearer ********"
};

const data = {
  product_id: "694832d8b54506f955d789e7",
  parameters: {
    "action": "balance",
    "address": []
  }
};

axios.post(url, data, { headers })
  .then(response => {
    console.log(response.status);
    console.log(response.data);
  })
  .catch(error => {
    console.error("Error:", error.message);
  });

Login to view your API and budget keys. The example above uses placeholder values. Sign in to see personalized code with your bearer token.

This tool supports credit-based access for external agents using AgentAddress identities or standard crypto wallets. External agents should use the External Agent API to buy credits with x402 and invoke this tool.

1. Buy Credits

Purchase credits via x402 payment (500 credit minimum, 100 credits = $1).

# Request payment requirements (returns 402 + PAYMENT-REQUIRED header)
curl -i -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

# Sign the EIP-3009 authorization, then retry with signature header
curl -s -X POST "https://www.agentpmt.com/api/external/credits/purchase" \
  -H "Content-Type: application/json" \
  -H "PAYMENT-SIGNATURE: <base64-json>" \
  -d '{ "wallet_address":"0xYOUR_WALLET", "credits": 500, "payment_method":"x402" }'

2. Create a Session Nonce (nonce used in signed balance/invoke)

curl -s -X POST "https://www.agentpmt.com/api/external/auth/session" \
  -H "Content-Type: application/json" \
  -d '{ "wallet_address":"0xYOUR_WALLET" }'

3. Invoke This Tool

Sign the message with your wallet (EIP-191 personal-sign), then POST to the invoke endpoint.

# Sign this message (wallet MUST be lowercased):
# agentpmt-external
# wallet:0xyourwallet...
# session:<session_nonce>
# request:<request_id>
# action:invoke
# product:694832d8b54506f955d789e7
# payload:<sha256(canonical_json(parameters))>

curl -s -X POST "https://www.agentpmt.com/api/external/tools/694832d8b54506f955d789e7/invoke" \
  -H "Content-Type: application/json" \
  -d '{
    "wallet_address": "0xYOUR_WALLET",
    "session_nonce": "<session_nonce>",
    "request_id": "invoke-uuid",
    "signature": "0x<signature>",
    "parameters": {
      "action": "your_action",
      "your_param": "value"
    }
  }'

Actions(5)

balance^5cr2 params(1 required)

Get native token balance (ETH or MATIC) for one or more wallet addresses. Returns balance in both native units and wei.

addressrequiredarray

Ethereum address(es) to query. Must be 0x-prefixed 42-character hex strings. 1 to 20 addresses allowed.

Array of: string

chainstring

Blockchain network to query. Default: ethereum.

Values:

ethereumbasebase_sepoliapolygonarbitrumoptimism

token_balance^5cr3 params(1 required)

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

addressrequiredarray

Ethereum address(es) to query. Must be 0x-prefixed 42-character hex strings. 1 to 20 addresses allowed.

Array of: string

chainstring

Blockchain network to query. Default: ethereum.

Values:

ethereumbasebase_sepoliapolygonarbitrumoptimism

tokenstring

Token symbol to query (e.g., 'USDC', 'USDT', 'PYUSD', 'DAI', 'WETH'). Use 'all' to get all supported tokens on the selected chain. Defaults to 'all' if not provided.

transactions^5cr3 params(1 required)

Get paginated transaction history for a single address. Returns 100 transactions per request sorted by most recent first.

addressrequiredarray

Exactly 1 wallet address to query. Must be 0x-prefixed 42-character hex string.

Array of: string

chainstring

Blockchain network to query. Default: ethereum.

Values:

ethereumbasebase_sepoliapolygonarbitrumoptimism

transaction_rangearray

Range of transactions to fetch as [start, end] integers. Must span exactly 100 transactions. Index 1 = most recent. Default: [1, 100].

Array of: integer

contract_abi^5cr2 params(1 required)

Retrieve the ABI (Application Binary Interface) JSON for a verified smart contract. Returns the full ABI array plus counts of functions and events.

addressrequiredarray

Exactly 1 contract address to query. Must be 0x-prefixed 42-character hex string.

Array of: string

chainstring

Blockchain network to query. Default: ethereum.

Values:

ethereumbasebase_sepoliapolygonarbitrumoptimism

gas_oracle^5cr1 param

Get current gas price estimates (safe/standard/fast) for a blockchain network. Returns prices in Gwei with EIP-1559 base fee suggestions.

chainstring

Blockchain network to query. Default: ethereum.

Values:

ethereumbasebase_sepoliapolygonarbitrumoptimism

Usage Instructions

Usage guidance provided directly by the developer for this product.

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:

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

Call balance to get native ETH/MATIC balance
Call token_balance with token: "all" to get all ERC-20 holdings

Investigate transaction activity

Call transactions with default range [1, 100] for the latest 100 transactions
Page through older transactions with [101, 200], [201, 300], etc.

Inspect a smart contract

Call contract_abi to retrieve the verified ABI
Use the ABI to understand available functions and events

Estimate transaction costs

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.

About The Developer

Apoth3osis

★15 stars

Joined Agent Payment: August 14, 2025

We build tools that enable AI agents to excel in the mathematical realm.

Our small team develops experimental and unique solutions in the AI arena, with a strong focus on modular computing for agentic applications and custom model deployment. We have handled projects for a variety of applications across many sectors, from algorithmic trading and financial analysis, to molecular simulations and predictions, to habitat and biodiversity monitoring and wildlife conservation.

Blockchain Scanner

Description