ToolVet
81trust / 100

Token Holders

by FiatDock in Onchain & crypto

x402 APIPassing, checked 38 min ago

Who holds an ERC-20: the top 10 holders with their share of supply and whether each is a contract, locked or a burn address, the LP holders and how much LP is locked, the creator's and owner's share, holder count, and concentration with burned/locked supply excluded. Base, Ethereum and five more chains. Send {} for USDC on Base. Pay-per-call via x402. An empty body is answered for USDC on Base (the x402 settlement asset); send {"token":"0x…"} for any other token.

POST https://fiatdock.com/v1/token/holders

Last 30 days

All checks passedSome failedAll failedNot checked
Uptime
100%
Response time
41 ms typical, 41 ms slowest 5%
Last check
38 min ago
Next check
any minute now

How to call it

# See the payment challenge (nothing is charged)
curl -i -X POST "https://fiatdock.com/v1/token/holders" \
  -H "content-type: application/json" \
  -d '{"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}'
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

const client = new x402Client().register(
  "eip155:8453",
  new ExactEvmScheme(privateKeyToAccount(process.env.AGENT_KEY)),
);
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? Preflight it first for $0.005:
// GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ffiatdock.com%2Fv1%2Ftoken%2Fholders
const res = await pay("https://fiatdock.com/v1/token/holders", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({"chain":"base","token":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"}),
});
console.log(await res.json());

Example input

{
  "chain": "base",
  "token": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913"
}

Example output

{
  "asOf": "2026-10-05T00:00:00.000Z",
  "creator": {
    "address": "0x0000000000000000000000000000000000000002",
    "pct": 0
  },
  "holderCount": 13057390,
  "lpHolderCount": null,
  "lpHolders": [],
  "lpLockedPct": 0,
  "name": "USD Coin",
  "network": "base",
  "note": "pct is the share of total supply; top10ControlledPct leaves out burn addresses and locked holdings.",
  "owner": null,
  "source": "GoPlus Security on-chain scan (top 10 holders)",
  "symbol": "USDC",
  "token": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
  "top10ControlledPct": 31.4,
  "top10Pct": 31.4,
  "topHolders": [
    {
      "address": "0x0000000000000000000000000000000000000001",
      "isBurn": false,
      "isContract": true,
      "isLocked": false,
      "pct": 6.12,
      "tag": null
    }
  ]
}

Security scan

  • No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.

Recent checks

WhenResultHTTPTimePrice
38 min agoPassed40241 ms$0.0027
6 h agoPassed40244 ms$0.0027