Api Endpoint

onchain.scrapemole.workers.dev

Use when you need who holds a token (concentration, whales, treasury): returns the top N holders of an ERC-20 contract on Base or Ethereum with rank, checksummed address, raw and formatted balance, and share of total supply when the explorer provides it. Public name tags and ENS from the explorer are included as labels; no personal identity is invented and emails are stripped. Ethereum prefers Blockscout, falls back to Ethplorer. Base uses Blockscout; if that explorer blocks the request, the call returns 503 and is not charged.

Open interactive test console

Offering

Provider: onchain.scrapemole.workers.dev
Method: GET
Offering type: Api Endpoint
Transport type: http
Category: Blockchain And Crypto
Delivery: Not provided
Pricing model: Not provided
x402 version: 2

Endpoint context

URL: https://onchain.scrapemole.workers.dev/v1/holders
MIME type: application/json
First seen: 2026-10-16T02:01:31.612Z
Last seen: 2026-11-02T06:05:36.198Z
Tags: None supplied

Website

Payment pricing

x402 payment terms are the authoritative price for calling this endpoint.

Payment option 1: 0.002 USDC
Atomic price: 2000 · Network: eip155:8453 · Asset: USDC · Scheme: exact
Payment option 2: 0.002 USDC
Atomic price: 2000 · Network: solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp · Asset: USDC · Scheme: exact

Raw x402 terms

[
  {
    "scheme": "exact",
    "network": "eip155:8453",
    "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
    "amount": "2000",
    "payTo": "0xCb535d13C7fC5Fe6C2B88da3f3601B840CCaf8Bc"
  },
  {
    "scheme": "exact",
    "network": "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp",
    "asset": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
    "amount": "2000",
    "payTo": "CGZW5WoP1eAZDZf4rjX2qiqZKr8czUEdq3VP1UE9JpSZ"
  }
]

Observed health

Status: Healthy
Latest latency: 1122 ms
Average latency: 1816 ms
HTTP status: 402
Last checked: 2026-11-02T06:05:36.193Z
Reachability: 92.9% over 14 checks

Latency is measured to the first response headers. A reachable result does not verify response accuracy or merchant identity.

Input schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "const": "http"
    },
    "method": {
      "type": "string",
      "enum": [
        "GET"
      ]
    },
    "queryParams": {
      "type": "object",
      "properties": {
        "address": {
          "type": "string",
          "examples": [
            "0xdAC17F958D2ee523a2206206994597C13D831ec7"
          ],
          "description": "Token contract address (0x…) on the chosen chain. Example: USDT on Ethereum (use with chain=ethereum)."
        },
        "chain": {
          "type": "string",
          "enum": [
            "base",
            "ethereum"
          ],
          "default": "base",
          "examples": [
            "ethereum"
          ],
          "description": "Chain. The example address is on Ethereum, so it needs chain=ethereum."
        },
        "limit": {
          "type": "string",
          "default": "10",
          "description": "Max holders to return (1-50)."
        }
      },
      "required": [
        "address"
      ],
      "additionalProperties": false
    }
  },
  "required": [
    "type",
    "method"
  ],
  "additionalProperties": false
}

Output schema

{
  "type": "object",
  "properties": {
    "type": {
      "type": "string"
    },
    "example": {
      "type": "object"
    }
  },
  "required": [
    "type"
  ]
}