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 json { "maxItems": 100, "sortBy": "market_cap", "orderBy": "desc" } ## Example Output json { "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.