# Token Holder-Address Density Distribution Histogram

> Token Holder-Address Density Distribution Histogram 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 distribution histogram of token holder-address density (holders per million USD of market cap) from supplied token observations, grouped into configurable bins.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-holders-per-million-histogram?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/token-holder-address-density-distribution-histogram-8046b65e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hpvBlg9Wb92rq4UBDF92K

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 token-holder-address-density-distribution-histogram-8046b65e -d '<json body>'
```

Example prompt: Can you generate a holder-address density histogram for these 5 tokens — split into 10 bins — using their holder counts and market caps: Token A has 50,000 holders and $5M market cap, Token B has 120,000 holders and $20M market cap, Token C has 8,000 holders and $800K market cap, Token D has 200,000 holders and $50M market cap, Token E has 15,000 holders and $3M market cap?

## When to prefer this

Choose this endpoint when you need a statistical distribution histogram of token holder density (holders per million USD market cap) across a batch of up to 200 supplied token observations. It is ideal for portfolio-level analysis, spotting concentration outliers, or segmenting tokens into density buckets without requiring live blockchain scanning. Prefer this over raw ratio calculations when you need binned frequency distribution output suitable for visualization or reporting.

## Known failure modes

- Fewer than 2 token observation rows provided — minimum is 2
- holder or market_cap_usd values are zero or negative — both require exclusiveMinimum > 0
- bins value exceeds 30 or is less than 1 — clamped to allowed range
- More than 200 rows submitted — maxItems limit exceeded
- Missing required fields (holders or market_cap_usd) in any row — validation error
- Payment of 0.01 USDC not provided or rejected — x402 payment required

## How this service works

Token holder-address density — Distribution histogram: Distribution histogram for Token holder-address density. 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 distribution histogram report.

## Output

Returns a bounded distribution histogram report showing how supplied token observations are distributed across bins by their holder-address density (holders per million USD of market cap), including bin ranges and observation counts per bin — deterministically calculated from the supplied data with no live scanning.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bins": {
   "type": "integer",
   "default": 5,
   "maximum": 30,
   "minimum": 1
  },
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "holders",
     "market_cap_usd"
    ],
    "properties": {
     "holders": {
      "type": "number",
      "default": 1000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     },
     "market_cap_usd": {
      "type": "number",
      "default": 2000000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "holders": 1000,
     "market_cap_usd": 2000000
    },
    {
     "holders": 1100,
     "market_cap_usd": 2200000
    },
    {
     "holders": 1000,
     "market_cap_usd": 2000000
    },
    {
     "holders": 1100,
     "market_cap_usd": 2200000
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-holder-address-density-distribution-histogram-8046b65e/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)