Tools · Token Holders
Token Top Holders (Sampled): Top holders of an ERC-20 by received volume in a sample of its most recent transfers, with per-holder counts and sample concentration. A transfer sample, not balances or the full holder list. Pay per call in USDC on Base via x402 — POST https://x402.freeq.one/tools/token_holders.
POST https://x402.freeq.one/tools/token_holders
0.004 USDC on Base · payTo 0x90b0dC893406d6eA63bb077ED59F5e8340f98d84
Status: verified · payable
Operator badge: embed this endpoint's live status badge — it reads "Verified Payable" only while the probe record backs it.
Settlement: direct to the seller's payTo — 0% HIVE402 take
Payment routes
{
"address": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
"chain": "eth",
"sample_limit": 200,
"top_n": 10
}{
"content": [],
"isError": false,
"structuredContent": {}
}Script Master Labs LLC · SDVOSB · Kinston, NC · Terms · Refunds · Privacy · Contact
SML network: ScriptMasterLabs — the main site · SML Dual Market — the human storefront · VA Ratings — VA disability ratings, free for veterans
Agent intel 
| Trust score | 64 / 100 · breakdown |
|---|---|
| Probe uptime (30d) | 100.0% over 1 probes · daily |
| Avg 402 latency | 196 ms |
| Paid calls (30d, on-chain) | 0 calls · 0 buyers |
| Facilitator-reported (30d) | 1 calls · 1 payers (CDP Bazaar) |
How to call
POST https://x402.freeq.one/tools/token_holders · input in body · spec from live-challenge
Input schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Token contract address, 0x-prefixed, 42 chars",
"example": "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48"
},
"chain": {
"type": "string",
"description": "Chain key: eth, arb, base, polygon, opt",
"example": "eth"
},
"sample_limit": {
"type": "integer",
"description": "Most recent transfers sampled, 1-1000 (default 200)",
"example": 200
},
"top_n": {
"type": "integer",
"description": "Top holders returned, 1-25 (default 10)",
"example": 10
}
},
"description": "JSON request body. See GET /tools for the parameter catalog."
}Output schema
{
"type": "object",
"properties": {
"content": {
"type": "array"
},
"isError": {
"type": "boolean"
},
"structuredContent": {
"type": "object"
}
}
}curl -i -X POST 'https://x402.freeq.one/tools/token_holders' \
-H 'content-type: application/json' -d '{"address":"0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48","chain":"eth","sample_limit":200,"top_n":10}'
Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs