# Largest Reported Token Holder Share — Record Ranking

> Largest Reported Token Holder Share — Record Ranking is a paid API for AI agents from market.datapackvibe.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-15).

Ranks up to 200 supplied token holder share observations by calculated holder percentage, returning a deterministic record ranking report.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-largest-holder-rank?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/largest-reported-token-holder-share-record-ranking-ea73a6b3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_qKBi-ZIRlRDQYSIczEgN-

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability largest-reported-token-holder-share-record-ranking-ea73a6b3 -d '<json body>'
```

Example prompt: Can you rank these 4 token holder observations by their share of circulating supply? Holder 1 has 100,000 tokens out of 1,000,000 circulating, Holder 2 has 110,000 out of 1,100,000, Holder 3 has 500,000 out of 2,000,000, and Holder 4 has 250,000 out of 800,000 — tell me which has the largest reported holder share.

## When to prefer this

Choose this endpoint when you need a fast, deterministic rank of multiple token holder share observations using supplied data rather than live on-chain queries. Ideal for offline analytics, snapshot comparisons, governance power assessments, or token concentration audits where you already have the holder and circulating supply figures. Not suitable for live blockchain scanning, safety proofs, or trade recommendations.

## Known failure modes

- Fewer than 2 rows supplied (minItems: 2 violation) — request rejected
- circulating_tokens of 0 supplied (exclusiveMinimum: 0 violation) — division by zero prevented by schema
- holder_tokens or circulating_tokens exceeds 10^16 maximum — request rejected
- More than 200 rows supplied (maxItems: 200 violation) — request rejected
- Missing required fields holder_tokens or circulating_tokens in any row — validation error

## How this service works

Largest reported token holder share — Record ranking: Record ranking for Largest reported token holder share. Supplied token observations only. Deterministic calculation or caller-threshold verdict, not a live scan, safety proof or trade recommendation. Specialised preset in a shared 50-profile, 20-operation engine. 0.01 USDC includes one bounded record ranking report.

## Output

A deterministic record ranking report showing the supplied token holder observations sorted and ranked by their calculated holder share (holder_tokens divided by circulating_tokens), identifying which record holds the largest reported share. The report is bounded to the supplied observations only and is not a live scan or safety verdict.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "holder_tokens",
     "circulating_tokens"
    ],
    "properties": {
     "holder_tokens": {
      "type": "number",
      "default": 100000,
      "maximum": 10000000000000000,
      "minimum": 0
     },
     "circulating_tokens": {
      "type": "number",
      "default": 1000000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "holder_tokens": 100000,
     "circulating_tokens": 1000000
    },
    {
     "holder_tokens": 110000.00000000001,
     "circulating_tokens": 1100000
    },
    {
     "holder_tokens": 100000,
     "circulating_tokens": 1000000
    },
    {
     "holder_tokens": 110000.00000000001,
     "circulating_tokens": 1100000
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/largest-reported-token-holder-share-record-ranking-ea73a6b3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from market.datapackvibe.com](https://www.zero.xyz/host/market.datapackvibe.com/llms.txt)