base

Query Base blockchain wallets, tokens, transactions, and gas data via JSON-RPC and CoinGecko.

14|5|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill base-mlt-oss
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: base
Source: https://github.com/MLT-OSS/hermes-agent-go/tree/main/optional-skills/blockchain/base
Command: npx skills add https://github.com/MLT-OSS/hermes-agent-go --skill base-mlt-oss

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? It retrieves on-chain data from the Base (Ethereum L2) network—wallet balances, token metadata, transaction details, gas costs, and network stats—enriched with USD pricing, without requiring any API key or external Python packages. ## Core Features & Use Cases - Wallet Portfolio: Check ETH balance and holdings across ~15 known Base tokens (USDC, WETH, AERO, DEGEN) with USD valuations and dust filtering. - Transaction & Contract Inspection: Decode transaction receipts including ERC-20/ERC-721 transfers, detect contract types (ERC-20/721/1155), and resolve EIP-1967 proxy implementations. - Gas & Network Analysis: View 10-block base fee trends, block utilization, and cost estimates for transfers and swaps, plus live network health stats. - Use Case: Ask for the portfolio value of a Base wallet address and receive a sorted token list with prices and a total USD value, all from public RPC endpoints. ## Quick Start Ask the agent to check the wallet balance and token holdings of a Base address such as 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045.

Frequently Asked Questions about base

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I check a Base wallet balance and token holdings?

Run the wallet command with the address: python3 base_client.py wallet <address>. It checks ETH balance plus ~15 known Base tokens via balanceOf calls and returns USD values sorted by worth. Use --no-prices for faster RPC-only results.

How to look up ERC-20 token price and market cap on Base?

Use the token command with the contract address to read name, symbol, decimals, and total supply on-chain, then fetch USD price and market cap from CoinGecko. The price command also accepts known symbols like ETH, USDC, AERO, or DEGEN.

Does this tool require an API key or paid RPC endpoint?

No API key is required. It uses Base's public RPC (https://mainnet.base.org) and CoinGecko's free tier. For higher rate limits, set the BASE_RPC_URL environment variable to a private endpoint from Alchemy, QuickNode, or Infura.

Why does the wallet command not show all my ERC-20 tokens?

EVM chains have no RPC method to enumerate all tokens, so the wallet command only checks ~15 known Base tokens via balanceOf calls. Unknown ERC-20s will not appear; use the token command with a specific contract address instead.

Why are Base gas estimates different from actual transaction costs?

The gas command estimates L2 execution costs only. Base is an L2, so real transaction costs also include an L1 data posting fee that depends on calldata size and current L1 gas prices, which is not included in the estimate.

What are the limitations of the whale detection feature?

The whales command scans only the most recent block for large ETH transfers, making it a point-in-time snapshot rather than historical analysis. The default threshold is 1.0 ETH, adjustable with the --min-eth flag.