# Largest Reported Token Holder Share — Weighted Result Mean

> Largest Reported Token Holder Share — Weighted Result Mean 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).

Computes a weighted mean of the largest reported token holder share (holder_tokens / circulating_tokens) across up to 200 supplied observations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-largest-holder-weighted-mean?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-weighted-result-mean-628b6a8f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tG3k_jKD7p6O0pOtGP3MZ

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-weighted-result-mean-628b6a8f -d '<json body>'
```

Example prompt: Calculate the weighted mean of the largest token holder share for these 4 observations: [100000 holder tokens out of 1000000 circulating, weight 1], [110000 out of 1100000, weight 2], [100000 out of 1000000, weight 1], [110000 out of 1100000, weight 2].

## When to prefer this

Choose this endpoint when you need a deterministic, weighted statistical summary of token holder concentration across multiple discrete observations or time periods, and you want to assign varying importance (weights) to each data point. Prefer it over simple mean endpoints when observations differ in reliability or recency. Not suitable for live on-chain scanning or real-time holder lookups.

## Known failure modes

- Fewer than 2 rows provided — minimum of 2 observations required
- circulating_tokens is zero or negative — exclusiveMinimum constraint violated
- rows and weights arrays have mismatched lengths
- holder_tokens or circulating_tokens exceed maximum value of 10^16
- More than 200 rows supplied — exceeds maxItems constraint
- Payment of 0.01 USDC not provided or rejected via x402 protocol

## How this service works

Largest reported token holder share — Weighted result mean: Weighted result mean 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 weighted result mean report.

## Output

Returns a single weighted mean value representing the average largest token holder share (holder_tokens / circulating_tokens ratio) across the supplied observations, calculated deterministically using the provided weights. This is a statistical aggregate only — not a live scan, safety proof, or trade recommendation.

## 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
  },
  "weights": {
   "type": "array",
   "items": {
    "type": "number",
    "default": 1,
    "maximum": 1000000000000,
    "minimum": 0
   },
   "default": [
    1,
    2,
    1,
    2
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/largest-reported-token-holder-share-weighted-result-mean-628b6a8f/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)