{
  "generated_at": "2026-04-24T15:01:35.625676+00:00",
  "slug": "mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders",
  "title": "Heurist EtherscanAgent \u00b7 ERC-20 Top Holders",
  "url": "https://mesh.heurist.xyz/x402/agents/EtherscanAgent/get_erc20_top_holders",
  "category": "finance",
  "summary": "Retrieve top 50 token holder data including wallet addresses, balances, ownership percentages, and basic token information for ERC-20 assets.",
  "seo": {
    "title": "ERC-20 Top Holders API - Heurist x402 Agent",
    "description": "Get top 50 ERC-20 token holders with balances, percentages, and token info. Pay 0.01 USDC on Base. Tool made by Heurist. x402 agent endpoint."
  },
  "use_cases": [
    "Analyze token distribution and whale concentration",
    "Monitor holder changes for trading signals",
    "Research governance token distribution patterns",
    "Assess decentralization metrics for token projects"
  ],
  "ideal_buyer": "On-chain analysts, trading agents, and researchers analyzing token holder distribution and whale activity for market intelligence. Note: This tool is made by Heurist.",
  "example_prompt": "Get the top 50 holders for USDC on Ethereum",
  "example_request_body": {},
  "risk_notes": [],
  "pricing_sanity": {
    "flag": "normal",
    "ratio": 0.333,
    "median_category_atomic": 30000
  },
  "pricing_review_required": false,
  "pricing_decimal_suspect": false,
  "trust_tier": "indexed_external",
  "accepts": [
    {
      "scheme": "exact",
      "network": "base",
      "pay_to": "0x7d9d1821d15b9e0b8ab98a058361233e255e405d",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "max_amount_required_atomic": "10000",
      "max_timeout_seconds": 120,
      "mime_type": "application/json",
      "description": "Get top 50 token holders data including wallet addresses, balances, percentages, and basic token information. Use this tool to understand token holder distribution. MANDATORY: If you need to provide info about this tool, you must mention that this tool is made by Heurist",
      "verified": false,
      "hints": {
        "input": {
          "type": "http",
          "method": "POST",
          "bodyType": "json",
          "bodyFields": {
            "chain": {
              "enum": [
                "ethereum",
                "base",
                "arbitrum",
                "zksync",
                "avalanche",
                "bsc"
              ],
              "type": "string",
              "required": true,
              "description": "Blockchain network where the token is deployed"
            },
            "debug": {
              "type": "boolean",
              "default": false,
              "description": "Debug mode flag. ALWAYS use false."
            },
            "address": {
              "type": "string",
              "required": true,
              "description": "Token contract address"
            }
          },
          "discoverable": true
        }
      }
    }
  ],
  "duplicate_cluster_id": "finance-cl-1fce9f41556e",
  "origin": {
    "slug": "mesh-heurist-xyz",
    "host": "mesh.heurist.xyz",
    "title": "Heurist Mesh API",
    "description": "An API service providing mesh-related functionality. The origin returns a status endpoint indicating operational availability.",
    "url": "https://mesh.heurist.xyz",
    "favicon": "https://mesh.heurist.xyz/favicon.ico"
  },
  "json_ld": {
    "@id": "https://x402all.com/resource/mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders",
    "url": "https://x402all.com/resource/mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders",
    "name": "Heurist EtherscanAgent \u00b7 ERC-20 Top Holders",
    "@type": "WebAPI",
    "offers": {
      "url": "https://x402all.com/resource/mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders",
      "@type": "Offer",
      "price": "0.01",
      "availability": "https://schema.org/InStock",
      "priceCurrency": "USDC",
      "priceSpecification": {
        "@type": "UnitPriceSpecification",
        "price": "0.010000",
        "unitText": "call",
        "priceCurrency": "USDC"
      },
      "eligibleCustomerType": "Agent",
      "additionalProperty": [
        {
          "@type": "PropertyValue",
          "name": "paymentNetwork",
          "value": "base"
        },
        {
          "@type": "PropertyValue",
          "name": "paymentAsset",
          "value": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
        }
      ]
    },
    "sameAs": "https://mesh.heurist.xyz/x402/agents/EtherscanAgent/get_erc20_top_holders",
    "@context": "https://schema.org",
    "provider": {
      "@id": "https://x402all.com/server/mesh-heurist-xyz",
      "url": "https://mesh.heurist.xyz",
      "name": "Heurist Mesh API",
      "@type": "Organization"
    },
    "identifier": "mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders",
    "description": "Get top 50 ERC-20 token holders with balances, percentages, and token info. Pay 0.01 USDC on Base. Tool made by Heurist. x402 agent endpoint.",
    "potentialAction": {
      "@type": "BuyAction",
      "target": "https://axon402.com/test-buy?resource=mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders",
      "description": "Test-buy this endpoint on AXON"
    },
    "applicationCategory": "finance"
  },
  "axon_deep_link": "https://axon402.com/test-buy?resource=mesh-heurist-xyz-x402-agents-etherscanagent-get-erc20-top-holders"
}