How do I install the Etherscan skill?

Run npx get-skill add tomevault-io/etherscan in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Etherscan safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Etherscan?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Etherscan free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Etherscan?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Etherscan by tomevault-io — Agent Skill

Name: Etherscan
Author: tomevault-io

File contents

Multi-chain Explorer API

Query Etherscan-compatible block explorer APIs for transaction history, contract source code, ABIs, and gas data.

Supported Explorers

Chain	Base URL	Env Var (optional override)
Ethereum	`https://api.etherscan.io/api`	`ETHERSCAN_API_KEY`
BSC	`https://api.bscscan.com/api`	`BSCSCAN_API_KEY` or same key
Polygon	`https://api.polygonscan.com/api`	`POLYGONSCAN_API_KEY`
Arbitrum	`https://api.arbiscan.io/api`	`ARBISCAN_API_KEY`
Optimism	`https://api-optimistic.etherscan.io/api`	`OPTIMISM_API_KEY`
Base	`https://api.basescan.org/api`	`BASESCAN_API_KEY`

All explorers accept the apikey parameter. Many share a single Etherscan key, but some chains require separate registration.

Rate limit: 5 calls/second per key.

Modules & Actions

Account — Transaction History

?module=account&action=txlist&address={addr}&startblock=0&endblock=99999999&page=1&offset=20&sort=desc&apikey={key}

Returns normal transactions for an address.

Account — Token Transfers (ERC-20)

?module=account&action=tokentx&address={addr}&page=1&offset=20&sort=desc&apikey={key}

Filter by contract: add &contractaddress={token}

Account — ERC-721 Transfers

?module=account&action=tokennfttx&address={addr}&page=1&offset=20&sort=desc&apikey={key}

Account — Balance

?module=account&action=balance&address={addr}&tag=latest&apikey={key}

Returns balance in wei. Divide by 1e18 for ETH/BNB.

Contract — Get ABI

?module=contract&action=getabi&address={addr}&apikey={key}

Returns the contract ABI as a JSON string. Tip: Parse the result and pass it to read_contract or write_contract for dynamic contract interaction.

Contract — Get Source Code

?module=contract&action=getsourcecode&address={addr}&apikey={key}

Returns source code, compiler version, constructor arguments, and proxy implementation address if applicable.

Gas Tracker (Ethereum only)

?module=gastracker&action=gasoracle&apikey={key}

Returns SafeGasPrice, ProposeGasPrice, FastGasPrice in gwei.

Workflow: Dynamic Contract Interaction

User provides a contract address
Call getabi to fetch the ABI
Parse the ABI to list available read/write functions
Use read_contract with the ABI and function name to query
Use write_contract for state-changing calls (with user confirmation)

This enables interacting with ANY verified contract without pre-built tools.

Usage Notes

Always include &apikey={key} — requests without it are heavily rate-limited
Use offset and page for pagination; don't fetch more than needed
The getabi endpoint only works for verified contracts
For proxy contracts, getsourcecode includes the implementation address — fetch that ABI too
Cross-reference contract data with security-check skill for risk assessment

Example Queries

User: "Show my recent transactions on BSC" → Call BSCScan txlist for active wallet, present last 10 with value and status

User: "Get the ABI for this contract: 0x..." → Call getabi, parse result, summarize available functions

User: "What's the current gas price on Ethereum?" → Call gasoracle, present safe/standard/fast prices

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: etherscandescription: Query block explorer APIs (Etherscan, BSCScan, Polygonscan, etc.) for transactions, contracts, and gas data. Use when this capability is needed.---# Multi-chain Explorer APIQuery Etherscan-compatible block explorer APIs for transaction history, contract source code, ABIs, and gas data.## Supported Explorers| Chain | Base URL | Env Var (optional override) || -------- | ----------------------------------------- | ----------------------------- || Ethereum | `https://api.etherscan.io/api` | `ETHERSCAN_API_KEY` || BSC | `https://api.bscscan.com/api` | `BSCSCAN_API_KEY` or same key || Polygon | `https://api.polygonscan.com/api` | `POLYGONSCAN_API_KEY` || Arbitrum | `https://api.arbiscan.io/api` | `ARBISCAN_API_KEY` || Optimism | `https://api-optimistic.etherscan.io/api` | `OPTIMISM_API_KEY` || Base | `https://api.basescan.org/api` | `BASESCAN_API_KEY` |All explorers accept the `apikey` parameter. Many share a single Etherscan key, but some chains require separate registration.**Rate limit**: 5 calls/second per key.## Modules & Actions### Account — Transaction History```?module=account&action=txlist&address={addr}&startblock=0&endblock=99999999&page=1&offset=20&sort=desc&apikey={key}```Returns normal transactions for an address.### Account — Token Transfers (ERC-20)```?module=account&action=tokentx&address={addr}&page=1&offset=20&sort=desc&apikey={key}```Filter by contract: add `&contractaddress={token}`### Account — ERC-721 Transfers```?module=account&action=tokennfttx&address={addr}&page=1&offset=20&sort=desc&apikey={key}```### Account — Balance```?module=account&action=balance&address={addr}&tag=latest&apikey={key}```Returns balance in wei. Divide by 1e18 for ETH/BNB.### Contract — Get ABI```?module=contract&action=getabi&address={addr}&apikey={key}```Returns the contract ABI as a JSON string. **Tip**: Parse the result and pass it to `read_contract` or `write_contract` for dynamic contract interaction.### Contract — Get Source Code```?module=contract&action=getsourcecode&address={addr}&apikey={key}```Returns source code, compiler version, constructor arguments, and proxy implementation address if applicable.### Gas Tracker (Ethereum only)```?module=gastracker&action=gasoracle&apikey={key}```Returns SafeGasPrice, ProposeGasPrice, FastGasPrice in gwei.## Workflow: Dynamic Contract Interaction1. User provides a contract address2. Call `getabi` to fetch the ABI3. Parse the ABI to list available read/write functions4. Use `read_contract` with the ABI and function name to query5. Use `write_contract` for state-changing calls (with user confirmation)This enables interacting with ANY verified contract without pre-built tools.## Usage Notes- Always include `&apikey={key}` — requests without it are heavily rate-limited- Use `offset` and `page` for pagination; don't fetch more than needed- The `getabi` endpoint only works for verified contracts- For proxy contracts, `getsourcecode` includes the implementation address — fetch that ABI too- Cross-reference contract data with `security-check` skill for risk assessment## Example QueriesUser: "Show my recent transactions on BSC"→ Call BSCScan `txlist` for active wallet, present last 10 with value and statusUser: "Get the ABI for this contract: 0x..."→ Call `getabi`, parse result, summarize available functionsUser: "What's the current gas price on Ethereum?"→ Call `gasoracle`, present safe/standard/fast prices---> Converted and distributed by [TomeVault](https://tomevault.io/claim/termix-official) — claim your Tome and manage your conversions.

Frequently asked questions

Etherscan