# Reported Top-Holder Group Share — Named Scenario Comparison

> Reported Top-Holder Group Share — Named Scenario Comparison 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-16).

Compares named scenarios for top-holder group share concentration, computing how a token group's ownership percentage shifts under different supply or holding configurations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-top-group-scenario?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/reported-top-holder-group-share-named-scenario-comparison-bb1696a1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jj4knROd5GpYSNOFxXtvr

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 reported-top-holder-group-share-named-scenario-comparison-bb1696a1 -d '<json body>'
```

Example prompt: Compare top-holder group concentration scenarios for a token: baseline is 400,000 group tokens out of 1,000,000 circulating, then show me a scenario called 'Whale Accumulation' where the group holds 550,000 tokens instead.

## When to prefer this

Use this endpoint when you need a deterministic, named scenario comparison of top-holder group share percentages based on caller-supplied token counts — not live blockchain data. Prefer this over generic computation tools when you want structured multi-scenario output with labeled results, and when you need to compare up to 20 named alternatives against a single baseline in one call at minimal cost ($0.01 USDC).

## Known failure modes

- circulating_tokens set to zero triggers exclusiveMinimum validation error
- scenarios array empty or exceeds 20 items returns validation error
- missing required baseline fields (group_tokens or circulating_tokens) causes rejection
- scenario override object has no properties (minProperties:1 violation)
- scenario label exceeds 80 characters or is empty string triggers schema error
- group_tokens or circulating_tokens exceeds maximum value of 10^16

## How this service works

Reported top-holder group share — Named scenario comparison: Named scenario comparison for Reported top-holder group 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 named scenario comparison report.

## Output

A structured report containing the baseline top-holder group share percentage and the computed group share for each named scenario, enabling direct comparison of concentration levels across different token supply and holding configurations. Results are deterministic calculations based on caller-supplied figures, not live on-chain data.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "baseline": {
   "type": "object",
   "default": {
    "group_tokens": 400000,
    "circulating_tokens": 1000000
   },
   "required": [
    "group_tokens",
    "circulating_tokens"
   ],
   "properties": {
    "group_tokens": {
     "type": "number",
     "default": 400000,
     "maximum": 10000000000000000,
     "minimum": 0
    },
    "circulating_tokens": {
     "type": "number",
     "default": 1000000,
     "maximum": 10000000000000000,
     "minimum": 0,
     "exclusiveMinimum": 0
    }
   },
   "additionalProperties": false
  },
  "scenarios": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "label",
     "overrides"
    ],
    "properties": {
     "label": {
      "type": "string",
      "maxLength": 80,
      "minLength": 1
     },
     "overrides": {
      "type": "object",
      "properties": {
       "group_tokens": {
        "type": "number",
        "default": 400000,
        "maximum": 10000000000000000,
        "minimum": 0
       },
       "circulating_tokens": {
        "type": "number",
        "default": 1000000,
        "maximum": 10000000000000000,
        "minimum": 0,
        "exclusiveMinimum": 0
       }
      },
      "minProperties": 1,
      "additionalProperties": false
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "label": "Supplied alternative",
     "overrides": {
      "group_tokens": 440000.00000000006
     }
    }
   ],
   "maxItems": 20,
   "minItems": 1
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/reported-top-holder-group-share-named-scenario-comparison-bb1696a1/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)