Token Holder Count History
Returns the validated holder-count page for one token on Ethereum, Base, BNB Smart Chain, or Arbitrum. pageSize is the requested target. The delivered page may be larger and has at most 10 rows.
POST https://agentapimarket.com/api/v1/token-holder-count-history
0.002 USDC on Base · payTo 0xa0679946b8f74c778566b5250a345932259be0c4
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
{
"chain": "ethereum",
"contractAddress": "0x3333333333333333333333333333333333333333",
"pageSize": 10
}{
"data": {
"blockchain": "eth",
"chain": "ethereum",
"contractAddress": "0x3333333333333333333333333333333333333333",
"holderCountHistory": [
{
"holderCount": 4498953,
"lastUpdatedAt": "2022-07-29T05:41:21Z",
"totalAmount": "36819785005.419766",
"totalAmountRawInteger": "36819785005419766"
}
],
"network": "eip155:1",
"tokenDecimals": 6
},
"ok": true,
"service": "chain.tokenHolderCountHistory"
}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 | 139 ms |
| Paid calls (30d, on-chain) | 0 calls · 0 buyers |
| Facilitator-reported (30d) | 1 calls · 1 payers (CDP Bazaar) |
How to call
POST https://agentapimarket.com/api/v1/token-holder-count-history · input in body · spec from live-challenge
Input schema
{
"type": "object",
"properties": {
"chain": {
"type": "string",
"enum": [
"ethereum",
"base",
"bsc",
"arbitrum"
],
"description": "ethereum, base, bsc, or arbitrum"
},
"contractAddress": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]{40}$",
"description": "0x-prefixed 20-byte token contract address"
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Optional integer from 1 to 10. The default is 10. It is the target count sent to the provider, not a strict output limit"
}
},
"required": [
"chain",
"contractAddress"
],
"additionalProperties": false
}Output schema
{
"type": "object"
}curl -i -X POST 'https://agentapimarket.com/api/v1/token-holder-count-history' \
-H 'content-type: application/json' -d '{"chain":"ethereum","contractAddress":"0x3333333333333333333333333333333333333333","pageSize":10}'
Agents: POST https://hive402.scriptmasterlabs.com/mcp → route_task / proxy_call · SDK /sdk/hive402.mjs