Showing the first 18000 characters. Load the complete file to read the remainder.
# Etherscan API
> The complete onchain data API for the crypto ecosystem, across 60+ chains.
## Instructions
To work with the Etherscan API, start with these pages:
- Get a key and make your first call: [Set Up Your API Key](https://docs.etherscan.io/set-up-your-api-key.md), [Make Your First Call](https://docs.etherscan.io/make-your-first-call.md)
- Supported chains and chain IDs: [Supported Chains](https://docs.etherscan.io/supported-chains.md)
- Every endpoint, by module: [Endpoint Overview](https://docs.etherscan.io/endpoint-overview.md)
- Common use cases and recipes: [Common Use Cases](https://docs.etherscan.io/common-use-cases.md)
- Rate limits and plans: [Rate Limits](https://docs.etherscan.io/rate-limits.md)
- Name tags, labels, and address reputation: [Etherscan Metadata](https://docs.etherscan.io/metadata/introduction.md)
- Build with an AI agent (MCP, CLI, and skills): [Build with AI](https://docs.etherscan.io/build-with-ai/introduction.md)
To query live onchain data from an agent without an API key, connect the keyless Etherscan MCP server at `https://mcp-keyless.etherscan.io/mcp` (Streamable HTTP, no authentication, 16 read-only tools, no PRO tools). For every tool, connect the authenticated server at `https://mcp.etherscan.io/mcp` with your API key. Setup: [Etherscan MCP](https://docs.etherscan.io/build-with-ai/mcp.md).
Append `.md` to any documentation URL for raw Markdown, or connect the [Docs MCP](https://docs.etherscan.io/build-with-ai/docs-mcp.md) at `https://docs.etherscan.io/mcp` to search these docs over MCP.
## Get Started (Overview)
- [Welcome to the Etherscan API](https://docs.etherscan.io/introduction.md): The complete onchain data API for the crypto ecosystem
- [Supported Chains](https://docs.etherscan.io/supported-chains.md): Every chain the Etherscan API supports, with its chain ID and plan availability.
## API Basics
- [Set Up Your API Key](https://docs.etherscan.io/set-up-your-api-key.md): Register an Etherscan account and create a free API key that works across all supported chains.
- [Make Your First Call](https://docs.etherscan.io/make-your-first-call.md): Make your first Etherscan API request with a worked curl example and a parameter breakdown.
- [Rate Limits](https://docs.etherscan.io/rate-limits.md): Rate limits and PRO-endpoint availability for each Etherscan API plan tier.
- [Common Error Messages](https://docs.etherscan.io/common-error-messages.md): Understand the errors the Etherscan API returns and how to resolve each one.
- [API Status](https://docs.etherscan.io/api-status.md): Check Etherscan API status and rule out issues in your own request when calls fail.
## Contract Verification (Guides)
- [Verify with the API](https://docs.etherscan.io/contract-verification/verify-with-api.md): Verify a deployed smart contract programmatically using the Etherscan API, on any supported chain with one key.
- [Get Verified Source Code](https://docs.etherscan.io/contract-verification/get-source-code.md): Retrieve a contract's published source code, ABI, and compiler settings with the Etherscan API.
- [Verify with Foundry](https://docs.etherscan.io/contract-verification/verify-with-foundry.md): Verify a smart contract on Etherscan using Foundry, at deployment or for an existing contract.
- [Verify with Hardhat](https://docs.etherscan.io/contract-verification/verify-with-hardhat.md): Verify a smart contract on Etherscan from a Hardhat project.
- [Verify with Remix](https://docs.etherscan.io/contract-verification/verify-with-remix.md): Verify a smart contract on Etherscan using the Remix contract verification plugin.
- [Common Verification Errors](https://docs.etherscan.io/contract-verification/common-verification-errors.md): Diagnose and fix common contract verification errors like bytecode and compiler mismatches.
## Endpoint Showcase
- [Address Page](https://docs.etherscan.io/endpoint-showcase/address.md): The endpoints behind an address page on etherscan.io.
- [Token Page](https://docs.etherscan.io/endpoint-showcase/token.md): The endpoints behind a token page on etherscan.io.
- [Block Page](https://docs.etherscan.io/endpoint-showcase/block.md): The endpoints behind a block page on etherscan.io.
- [Transaction Page](https://docs.etherscan.io/endpoint-showcase/transaction.md): The endpoints behind a transaction page on etherscan.io.
- [Gas Tracker](https://docs.etherscan.io/endpoint-showcase/gas-tracker.md): The endpoints behind the gas tracker on etherscan.io.
- [Contract Page](https://docs.etherscan.io/endpoint-showcase/contract.md): The endpoints behind a contract page on etherscan.io.
- [Charts and Stats](https://docs.etherscan.io/endpoint-showcase/charts-and-stats.md): The endpoints behind the charts and stats pages on etherscan.io.
## Common Use Cases
- [Wallet and Portfolio](https://docs.etherscan.io/resources/wallet-and-portfolio.md): Show users their full onchain picture: balances, activity, NFTs, and real names, across every chain.
- [Tax and Accounting](https://docs.etherscan.io/resources/tax-and-accounting.md): Build tax, accounting, and reporting workflows with transaction history, transfers, historical balances, and address metadata.
- [Security and Compliance](https://docs.etherscan.io/resources/security-and-compliance.md): Build security and compliance workflows with address labels, reputation data, funding traces, and contract information.
- [Onchain Analytics and Research](https://docs.etherscan.io/resources/analytics-and-research.md): Build dashboards, research reports, and protocol monitors from entity labels, holder distributions, event logs, and network stats.
## Guides
- [Best Practices](https://docs.etherscan.io/resources/best-practices.md): Practical tips for faster, more efficient Etherscan API requests, from pagination to block ranges.
## Resources (Overview)
- [Contact Us](https://docs.etherscan.io/resources/contact-us.md): How to reach Etherscan support, and the official channels the team communicates from.
- [Useful Links](https://docs.etherscan.io/resources/useful-links.md): Quick links to the accounts, keys, and reference pages you use most on the Etherscan API.
## Build with AI
- [Build with AI](https://docs.etherscan.io/build-with-ai/introduction.md): Connect AI agents and coding tools to the Etherscan API across 60+ chains, with MCP, a CLI, and skills.
## Core Tools
- [Etherscan MCP](https://docs.etherscan.io/build-with-ai/mcp.md): Connect AI agents to live Etherscan API data through the Model Context Protocol, with or without an API key.
- [Etherscan CLI](https://docs.etherscan.io/build-with-ai/cli.md): Query the Etherscan API from the terminal, scripts, and CI, with structured output for agents.
## Etherscan Skills
- [Etherscan Orchestrator](https://docs.etherscan.io/build-with-ai/skills/etherscan.md): The general skill that routes any onchain task to the right Etherscan interface: explorer website, API, CLI, or MCP.
- [Etherscan Flow](https://docs.etherscan.io/build-with-ai/skills/etherscan-flow.md): An installable agent skill that traces, verifies, and visualizes onchain money flows into an import-ready case file on [etherscan.io/flow](https://etherscan.io/flow).
- [Etherscan Contract Review](https://docs.etherscan.io/build-with-ai/skills/etherscan-contract-review.md): An installable agent skill that explains what a verified deployed contract does, with a source reference behind every claim.
- [Etherscan Transaction Debugger](https://docs.etherscan.io/build-with-ai/skills/etherscan-transaction-debugger.md): An installable agent skill that explains what a transaction did, and why, from live Etherscan data with verifiable evidence links.
## Use in AI Apps
- [ChatGPT Plugin](https://docs.etherscan.io/build-with-ai/chatgpt-plugin.md): Install the Etherscan plugin in ChatGPT and query live onchain data in chat, with no API key.
- [Claude Connector](https://docs.etherscan.io/build-with-ai/claude-connector.md): Add the Etherscan connector to Claude and query live onchain data in chat, with no API key.
## API Endpoints
- [Endpoint Overview](https://docs.etherscan.io/endpoint-overview.md): A complete list of Etherscan API endpoints, grouped by module.
## Account
- [Get Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balance.md): Retrieves the native token balance held by a specific address.
- [Get Native Balance for Multiple Addresses](https://docs.etherscan.io/api-reference/endpoint/balancemulti.md): Retrieves the native token balance held by multiple addresses in a single call.
- [Get Historical Native Balance for an Address](https://docs.etherscan.io/api-reference/endpoint/balancehistory.md): Retrieves the balance of a specified address at a given block height.
- [Get Normal Transactions By Address](https://docs.etherscan.io/api-reference/endpoint/txlist.md): Retrieves the transaction history of a specified address, with optional pagination.
- [Normal Transactions Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-txlist.md): Retrieves Normal Transactions with advanced from and to address filtering.
- [Get ERC20 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokentx.md): Retrieves ERC-20 token transfers, filtered by address and/or token contract.
- [ERC20 Token Transfers Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-tokentx.md): Retrieves ERC20 token transfers with advanced from and to address filtering.
- [Get ERC721 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/tokennfttx.md): Retrieves ERC-721 token transfers, filtered by address and/or token contract.
- [ERC721 Token Transfers Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-tokennfttx.md): Retrieves ERC721 token transfers with advanced from and to address filtering.
- [Get ERC1155 Token Transfers by Address](https://docs.etherscan.io/api-reference/endpoint/token1155tx.md): Retrieves ERC-1155 token transfers, filtered by address and/or token contract.
- [ERC1155 Token Transfers Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-token1155tx.md): Retrieves ERC1155 token transfers with advanced from and to address filtering.
- [Get Internal Transactions by Address](https://docs.etherscan.io/api-reference/endpoint/txlistinternal.md): Retrieves the internal transaction history of a specified address, with optional pagination.
- [Internal Transactions Advanced Filter](https://docs.etherscan.io/api-reference/endpoint/advanced-filter-txlistinternal.md): Retrieves Internal Transactions with advanced from and to address filtering.
- [Get Internal Transactions by Block Range](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-blockrange.md): Returns internal transactions within a specified block range, with optional pagination.
- [Get Internal Transactions by Transaction Hash](https://docs.etherscan.io/api-reference/endpoint/txlistinternal-txhash.md): Retrieves the list of internal transactions executed within a specific transaction.
- [Get Blocks Validated by Address](https://docs.etherscan.io/api-reference/endpoint/getminedblocks.md): Retrieves the list of blocks validated by a specified address.
- [Get Beacon Chain Withdrawals by Address](https://docs.etherscan.io/api-reference/endpoint/txsbeaconwithdrawal.md): Retrieves beacon chain withdrawals, optionally filtered by address.
- [Get Address Funded By](https://docs.etherscan.io/api-reference/endpoint/fundedby.md): Retrieves the address and transaction that first funded a specific EOA address, useful for tracing fund origins. Not available to contract addresses.
## Blocks
- [Get Block and Uncle Rewards by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockreward.md): Retrieves block rewards along with associated Uncle block rewards.
- [Get Block Transaction Counts by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblocktxnscount.md): Retrieves transaction counts for a specified Ethereum block.
- [Get Estimated Block Countdown by Block Number](https://docs.etherscan.io/api-reference/endpoint/getblockcountdown.md): Retrieves the estimated time, in seconds, until a specified block is mined.
- [Get Block Number by Timestamp](https://docs.etherscan.io/api-reference/endpoint/getblocknobytime.md): Retrieves the block number mined at a specific timestamp.
- [Get Daily Average Block Size](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocksize.md): Retrieves the average daily block size over a specified date range.
- [Get Daily Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblkcount.md): Retrieves the daily count of mined blocks along with the corresponding block rewards.
- [Get Daily Block Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyblockrewards.md): Retrieves the daily distribution of block rewards to miners.
- [Get Daily Average Block Time](https://docs.etherscan.io/api-reference/endpoint/dailyavgblocktime.md): Retrieves the daily average time taken to successfully mine a block.
- [Get Daily Uncle Block Count and Rewards](https://docs.etherscan.io/api-reference/endpoint/dailyuncleblkcount.md): Returns the daily count of Uncle blocks mined and their associated rewards.
## Contracts
- [Get Contract ABI](https://docs.etherscan.io/api-reference/endpoint/getabi.md): Retrieve the ABI for a verified smart contract.
- [Get Contract Source Code](https://docs.etherscan.io/api-reference/endpoint/getsourcecode.md): Retrieve the source code for a verified smart contract.
- [Get Contract Creator and Creation Tx Hash](https://docs.etherscan.io/api-reference/endpoint/getcontractcreation.md): Retrieve a contract's deployer address and creation transaction.
## Contract Verification
- [Verify Solidity Source Code](https://docs.etherscan.io/api-reference/endpoint/verifysourcecode.md): Submit a Solidity source code for verification.
- [Verify zkSync Source Code](https://docs.etherscan.io/api-reference/endpoint/verifyzksyncsourcecode.md): Submit zkSync source code for verification.
- [Verify Vyper Source Code](https://docs.etherscan.io/api-reference/endpoint/verifyvyper.md): Submit a Vyper contract for verification.
- [Verify Stylus Source Code](https://docs.etherscan.io/api-reference/endpoint/verifystylus.md): Submit Stylus source code for verification.
- [Verify Proxy Contract](https://docs.etherscan.io/api-reference/endpoint/verifyproxycontract.md): Submit a proxy contract for verification.
- [Check Source Code Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkverifystatus.md): Check the status of a source code verification request.
- [Check Proxy Contract Verification Status](https://docs.etherscan.io/api-reference/endpoint/checkproxyverification.md): Check the status of a proxy contract verification.
## Gas Tracker
- [Get Estimation of Confirmation Time](https://docs.etherscan.io/api-reference/endpoint/gasestimate.md): Estimate confirmation time based on a provided gas price.
- [Get Gas Oracle](https://docs.etherscan.io/api-reference/endpoint/gasoracle.md): Get current gas price recommendations.
- [Get Daily Average Gas Limit](https://docs.etherscan.io/api-reference/endpoint/dailyavggaslimit.md): Retrieve daily average gas limit statistics.
- [Get Ethereum Daily Total Gas Used](https://docs.etherscan.io/api-reference/endpoint/dailygasused.md): Retrieves the total daily gas usage for transactions within the network
- [Get Daily Average Gas Price](https://docs.etherscan.io/api-reference/endpoint/dailyavggasprice.md): Retrieve daily average gas price statistics.
## Geth/Parity Proxy
- [eth_blockNumber](https://docs.etherscan.io/api-reference/endpoint/ethblocknumber.md): Fetch the latest block number.
- [eth_getBlockByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblockbynumber.md): Get block information by number.
- [eth_getUncleByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgetunclebyblocknumberandindex.md): Get uncle block details by block number and index.
- [eth_getBlockTransactionCountByNumber](https://docs.etherscan.io/api-reference/endpoint/ethgetblocktransactioncountbynumber.md): Get the number of transactions in a block.
- [eth_getTransactionByHash](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyhash.md): Get transaction details by hash.
- [eth_getTransactionByBlockNumberAndIndex](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionbyblocknumberandindex.md): Get transaction details by block number and index.
- [eth_getTransactionCount](https://docs.etherscan.io/api-reference/endpoint/ethgettransactioncount.md): Get the number of transactions sent from an address.
- [eth_sendRawTransaction](https://docs.etherscan.io/api-reference/endpoint/ethsendrawtransaction.md): Broadcast a signed transaction to the network.
- [eth_getTransactionReceipt](https://docs.etherscan.io/api-reference/endpoint/ethgettransactionreceipt.md): Get the receipt of a transaction by hash.
- [eth_call](https://docs.etherscan.io/api-reference/endpoint/ethcall.md): Execute a call without creating a transaction.
- [eth_getCode](https://docs.etherscan.io/api-reference/endpoint/ethgetcode.md): Get the code stored at an address.
- [eth_getStorageAt](https://docs.etherscan.io/api-reference/endpoint/ethgetstorageat.md): Get the value at a storage position.
- [eth_gasPrice](https://docs.etherscan.io/api-reference/endpoint/ethgasprice.md): Get the current gas price.
- [eth_estimateGas](https://docs.etherscan.io/api-reference/endpoint/ethestimategas.md): Estimate the gas required for a transaction.
## Logs
- [Get Event Logs by Address](https://docs.etherscan.io/api-reference/endpoint/getlogs.md): Retrieves event logs from a specific address, with optional block range filtering.
- [Get Event Logs by Topics](https://docs.etherscan.io/api-reference/endpoint/getlogs-topics.md): Ret
Measured from the saved file
Linked document
UTF-8 text size
25.6 KB26192 bytes
Token count
5925o200k_base encoding
Markdown links
150142 distinct URLs
Fenced code blocks
0256 lines in the file
Size measures the captured UTF-8 text, not compressed transfer size. Tokens are counted with a named tokenizer; other models can count differently. Neither measure establishes context compatibility or answer quality.
Project H1
Etherscan API
Opening blockquote
The complete onchain data API for the crypto ecosystem, across 60+ chains.
Context architecture
How the content is divided
34 H2 sections organize 150 parsed Markdown links. 149 links point to .md or .markdown paths; 1 link occurrences use another hostname. Linked destinations have not been recursively validated.
H2 section
Links
UTF-8 bytes
Tokens
InstructionsLine 5
10
1453
382
Get Started (Overview)Line 21
2
284
68
API BasicsLine 26
5
774
184
Contract Verification (Guides)Line 34
6
1130
251
Endpoint ShowcaseLine 43
7
924
223
Common Use CasesLine 53
4
843
171
GuidesLine 60
1
176
40
Resources (Overview)Line 64
2
316
74
Build with AILine 69
1
182
48
Core ToolsLine 73
2
340
87
Etherscan SkillsLine 78
5
943
224
Use in AI AppsLine 85
2
350
90
API EndpointsLine 90
1
136
33
AccountLine 94
18
3502
734
BlocksLine 115
9
1622
346
ContractsLine 127
3
470
101
Show 18 more sections
H2 section
Links
UTF-8 bytes
Tokens
Contract VerificationLine 133
7
1067
236
Gas TrackerLine 143
5
761
170
Geth/Parity ProxyLine 151
14
2001
481
LogsLine 168
3
549
119
StatsLine 174
14
2471
546
TransactionsLine 191
2
374
72
TokensLine 196
11
2102
476
L2 Deposits/WithdrawalsLine 210
3
535
110
ENSLine 216
1
211
54
NametagsLine 220
1
155
37
UsageLine 224
2
302
73
Beta EndpointsLine 229
1
157
38
Get StartedLine 233
1
166
38
Metadata Exports (Multichain)Line 237
2
385
86
ResourcesLine 242
2
350
73
OptionalLine 247 · Optional
0
1
1
Metadata Exports (Legacy)Line 249
2
383
87
ChangelogLine 254
1
105
28
Link counts exclude parsed fenced and inline code and resolve relative destinations against the final endpoint. Section sizes cover the text below each H2 until the next H2.
Embedded material
Code, installation and API examples
Fenced blocks
0 closed
Declared languages
No fenced blocks detected
Package-install commands
0 detected in fenced or inline code
Authentication examples
0 fenced lines match API-key, Authorization, Bearer, OAuth or access-token patterns
HTTP request examples
0 fenced lines match request-method patterns
Authentication links
2 links have authentication-related labels
Embedded example text and links to further documentation are counted separately. A code block does not establish that a sample runs or that an authentication flow succeeds.
Publisher prioritization
The Optional section
1 H2 section named “Optional” contain 0 parsed links. 150 links sit outside those sections. That puts 0.0% of the file’s parsed links under Optional.
The community proposal uses Optional by convention for secondary links that can be skipped for a shorter context. This label does not establish that everything outside it is critical, or that the material inside it is deprecated.
Machine-readable routes
MCP references and configuration text
MCP-related text was detected in the captured file. 3 links have MCP-related labels or paths. 0 fenced lines match mcpServers, mcp_servers or an mcp add command.
A verified text response establishes a companion at the checked URL. It does not prove the bundle contains all product documentation, that generation is automated, or that it fits an assistant’s context window.
Change evidence
What can be said about freshness
This capture establishes a baseline. Update frequency cannot be determined from one observation.
Linked release and migration material
1 links have release, changelog, deprecation or migration terms in their labels or paths. These provide places to investigate product changes separately.
File changes can reveal documentation edits or navigation changes. They do not by themselves measure product release velocity, accuracy, agent adoption or AI visibility.
Counts use a deterministic parser, not a spec-compliance grade. Unusual Markdown and indented code can fall outside its recognized patterns. See the llms.txt proposal and tokenizer implementation.