# Largest Reported Token Holder Share — Ordered Trend Analysis

> Largest Reported Token Holder Share — Ordered Trend Analysis 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).

Analyzes ordered trend patterns in the largest reported token holder's share (holder tokens as a fraction of circulating tokens) across a sequence of observations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-largest-holder-trend?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-ordered-trend-analysis-a939f21e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7sTdWAmiMqXBVRMi_HkOT

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-ordered-trend-analysis-a939f21e -d '<json body>'
```

Example prompt: Can you run an ordered trend analysis on these token holder snapshots to see if the largest holder's share is increasing or decreasing? Here are 4 data points: holder_tokens [100000, 110000, 100000, 110000] and circulating_tokens [1000000, 1100000, 1000000, 1100000].

## When to prefer this

Choose this endpoint when you need a deterministic, low-cost ($0.01 USDC) ordered trend verdict on the largest token holder's percentage share across a sequence of historical or sampled observations. It is ideal for lightweight due-diligence checks, concentration monitoring, or pre-screening token projects without requiring a full live market scan or real-time feed. Prefer it over general analytics platforms when you already have your own holder and circulating supply data and need a fast, reproducible computation rather than data sourcing.

## Known failure modes

- Fewer than 2 rows submitted — minimum 2 observations required
- circulating_tokens value of 0 — excluded by exclusiveMinimum constraint
- holder_tokens or circulating_tokens exceeding maximum allowed value (1e16)
- More than 200 rows submitted — exceeds maxItems limit
- Malformed row objects missing required fields holder_tokens or circulating_tokens
- Payment failure or insufficient USDC balance for x402 micropayment

## How this service works

Largest reported token holder share — Ordered trend analysis: Ordered trend analysis 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 ordered trend analysis report.

## Output

Returns a deterministic ordered trend analysis report indicating the directional trend (e.g., increasing, decreasing, flat, or mixed) of the largest token holder's share across the submitted observation sequence, based on the ratio of holder_tokens to circulating_tokens at each row. No live market scan or safety guarantee is provided.

## 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-ordered-trend-analysis-a939f21e/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)