Pricing

Rating

Developer

Actor stats

Categories

Share

Etherscan Token Leaderboard Scraper

Scrape the Etherscan token leaderboard to extract comprehensive data about ERC-20 tokens on the Ethereum blockchain. Get real-time information about token prices, market caps, trading volumes, holder counts, and more.

Important Notes

• Minimum of 10 results per run
• Maximum of ~2500 (etherscans limit), an input of >2500 will return the maximum results

Features

• Comprehensive Token Data: Extracts rank, token name, symbol, price, 24h change percentage, trading volume, market caps, and holder counts
• Custom Sorting: Sort tokens by price, market cap, volume, 24h change, or number of holders
• Ascending/Descending Order: Control the sort direction for your specific needs
• Batch Processing: Efficiently fetches multiple pages concurrently for faster results

Example Input

{
"maxItems":100,
"sortBy":"market_cap",
"orderBy":"desc"
}

Example Output

{
"Rank":"1",
"Token":"Tether USD",
"Symbol":"USDT",
"Price":"$1.00",
"Change (%)":"-0.01",
"Volume (24H)":"$45,234,567,890",
"Circulating Market Cap":"$95,123,456,789",
"Onchain Market Cap":"$95,123,456,789",
"Holders":"5,234,567"
}

Field Descriptions

• Rank: Token's position on the leaderboard
• Token: Full name of the token
• Symbol: Token ticker symbol
• Price: Current price in USD
• Change (%): 24-hour price change percentage
• Volume (24H): Trading volume over the last 24 hours
• Circulating Market Cap: Market capitalization based on circulating supply
• Onchain Market Cap: Market capitalization based on total on-chain supply
• Holders: Number of unique wallet addresses holding the token
• Holders Change (%): 24-hour holder change percentage

Limitations

• Data is scraped from the public Etherscan website and reflects the information available at the time of scraping

Error Handling

The actor includes robust error handling:

• Invalid Inputs: If invalid parameters are provided (e.g., negative maxItems, invalid sortBy values), the actor will exit with an error message
• Failed Requests: If individual page requests fail, the actor logs the error and continues processing other pages
• Parsing Errors: If the HTML structure is unexpected, affected tokens are skipped while processing continues

Support

For issues, feature requests, or questions about this actor, please create an issue in the repository.