Etherscan APIetherscan.io ↗
Access Ethereum address balances, transactions, token transfers, NFT transfers, gas prices, and block details via the Etherscan API. 11 endpoints.
What is the Etherscan API?
This API exposes 11 endpoints covering Etherscan's core blockchain data: address overviews, transaction history, ERC-20 transfers, NFT transfers, block details, and live gas prices. The get_address_overview endpoint returns ETH balance, USD value, ENS name, and token holdings count for any valid Ethereum address, while get_gas_tracker delivers real-time low, average, and high gas prices with base and priority fee breakdowns.
curl -X GET 'https://api.parse.bot/scraper/086c5613-58b6-4812-8aea-da40196b8e5d/get_address_overview?address=0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns summary info for an Ethereum address: ETH balance, ETH value in USD, token holdings, labels, and ENS name. The address must be a valid 0x-prefixed Ethereum address or ENS-resolved address.
| Param | Type | Description |
|---|---|---|
| addressrequired | string | Ethereum address (0x-prefixed, 42 characters) |
{
"type": "object",
"fields": {
"labels": "array of strings - public name tags/labels",
"address": "string - the queried Ethereum address",
"ens_name": "string - ENS domain name if registered",
"eth_value": "string - ETH value in USD",
"eth_balance": "string - ETH balance with unit",
"token_holdings_count": "string - number of tokens held",
"token_holdings_summary": "string - summary of token holdings",
"token_holdings_value_usd": "string - total token holdings value in USD"
},
"sample": {
"data": {
"labels": [
"Gitcoin Grantee"
],
"address": "0xREDACTED_SECRET",
"ens_name": "vitalik.eth",
"eth_value": "$9,339.37 (@ $1,641.70/ETH)",
"eth_balance": "5.688840446715981478 ETH",
"token_holdings_count": ">401",
"token_holdings_summary": ">$95,810.00 (>401 Tokens)",
"token_holdings_value_usd": "95,810.00"
},
"status": "success"
}
}About the Etherscan API
Address and Transaction Data
The get_address_overview endpoint accepts a 0x-prefixed Ethereum address and returns eth_balance, eth_value (USD), ens_name, labels (public name tags), token_holdings_count, and token_holdings_value_usd. For a deeper look at holdings, get_address_token_holdings returns up to 200 ERC-20 tokens and all NFT holdings, each with token_address, balance, usd_value, rate, and type (ERC-20, ERC-721, or ERC-1155).
Transaction history is split across three paginated endpoints. get_address_transactions returns normal transactions with fields like hash, method, block, from, to, value, and fee data. get_address_internal_transactions covers internal calls with parent tx hash and type. get_address_erc20_token_transfers returns ERC-20 transfer events with token name and transfer amount. All three accept an optional page integer for pagination.
NFT Transfers, Blocks, and Search
get_address_nft_transfers returns ERC-721 and ERC-1155 transfer events, including token_id, nft_name, type, tx_hash, block_number, and total_records for the address. Individual transaction detail is available via get_transaction_details using a 66-character tx hash, returning fields like Transaction Fee, Gas Limit & Usage by Txn, Timestamp, and Block. Block-level data is accessible through get_block_details by block number, returning Fee Recipient, Block Reward, Gas Used, and Gas Limit.
Gas, Price, and Search
get_gas_tracker requires no inputs and returns low, avg, and high gas prices in gwei plus avg_detail, low_detail, and high_detail strings with base and priority fee breakdowns. get_eth_price_and_stats returns current eth_price in USD and med_gas_price. The search endpoint resolves Ethereum addresses, ENS names, transaction hashes, and block numbers, returning a type field (address, transaction, block, or search_results) and the resolved address or url.
The Etherscan API is a managed, monitored endpoint for etherscan.io — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when etherscan.io changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official etherscan.io API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Monitor wallet balances and USD value for a set of Ethereum addresses using
get_address_overview - Track ERC-20 token inflows and outflows for a DeFi protocol address with
get_address_erc20_token_transfers - Build a gas price alert system using real-time low/avg/high data from
get_gas_tracker - Audit NFT transfer history for a collector or contract address using
get_address_nft_transfers - Resolve ENS names to Ethereum addresses and look up balances via the
searchendpoint - Retrieve full transaction details including fees and gas usage for transaction receipt reconciliation
- Pull block reward and validator data from
get_block_detailsfor Ethereum network analysis
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Etherscan have an official developer API?+
What does `get_address_token_holdings` actually return, and are there limits?+
token_address, token_name, balance, usd_value, rate, and type (ERC-20, ERC-721, or ERC-1155). The endpoint reflects the address overview's token dropdown, which covers the first 200 ERC-20 tokens for a given address. Addresses holding more than 200 distinct ERC-20 tokens will only see the first 200 in the response.