How do I install the Etherscan skill?

Run npx skillmds@latest add majiayu000/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. Capability flags: makes network calls, reads secrets. 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?

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

Etherscan by majiayu000 — Agent Skill

Name: Etherscan
Rating: 4.2 (5 reviews)
Author: majiayu000

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

---name: etherscandescription: Query block explorer APIs (Etherscan, BSCScan, Polygonscan, etc.) for transactions, contracts, and gas data.--- # 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 1. User provides a contract address 2. Call `getabi` to fetch the ABI 3. Parse the ABI to list available read/write functions 4. Use `read_contract` with the ABI and function name to query 5. 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

Frequently asked questions

Etherscan