# Token Holder-Address Density — Adjacent Period Changes

> Token Holder-Address Density — Adjacent Period Changes 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).

Calculates period-over-period changes in token holder-address density (holders per million USD of market cap) for a supplied sequence of token observations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-holders-per-million-period-changes?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/token-holder-address-density-adjacent-period-changes-2983fe42
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NM2u-6cxZdumaxSOfzwSK

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-adjacent-period-changes-2983fe42 -d '<json body>'
```

Example prompt: Can you calculate the adjacent period changes in holder-address density for a token that had 1000 holders with a $2M market cap, then 1100 holders with a $2.2M market cap, and back to 1000 holders with a $2M market cap?

## When to prefer this

Use this endpoint when you have a series of token holder counts and market cap snapshots and need to compute how holder-address density shifts between consecutive periods. It is ideal for deterministic, reproducible analysis on supplied data rather than live on-chain queries. Prefer this over general analytics tools when you need a normalized, per-million-USD density metric with explicit period-change attribution.

## Known failure modes

- Fewer than 2 rows supplied — minimum input requirement not met
- Holder count or market cap value is zero or negative — exclusiveMinimum constraint violated
- More than 200 rows supplied — maxItems limit exceeded
- Non-numeric values in holders or market_cap_usd fields — type validation failure
- Payment not processed or insufficient USDC balance — x402 payment failure

## How this service works

Token holder-address density — Adjacent period changes: Adjacent period changes 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 adjacent period changes report.

## Output

A bounded report of adjacent period changes in token holder-address density (holders per million USD of market cap), computed deterministically from the supplied rows of holder counts and market cap values. Each result reflects the delta between consecutive input observations, not a live scan or external data fetch.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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-adjacent-period-changes-2983fe42/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)