# Token Circulating Market Cap Distribution Histogram

> Token Circulating Market Cap 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-16).

Computes a distribution histogram of token circulating market capitalization values from a supplied set of price and circulating-supply observations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-market-cap-histogram?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-circulating-market-cap-distribution-histogram-9a98991b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_n8iwCrCKlwlt68SOtPAbt

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-circulating-market-cap-distribution-histogram-9a98991b -d '<json body>'
```

Example prompt: Can you compute a 10-bin market cap distribution histogram for these token observations: [{price_usd: 2.0, circulating_tokens: 1000000}, {price_usd: 2.5, circulating_tokens: 1100000}, {price_usd: 3.0, circulating_tokens: 1200000}, {price_usd: 1.8, circulating_tokens: 950000}]?

## When to prefer this

Choose this endpoint when you have a set of token price and circulating supply observations and need a deterministic frequency distribution (histogram) of the resulting market cap values. It is ideal for offline batch analysis, scenario profiling, or data summarization rather than live price feeds. Prefer it over generic stats libraries when you want a pre-packaged, pay-per-call histogram report with configurable bin counts (1–30) and no infrastructure overhead.

## Known failure modes

- Fewer than 2 rows supplied — minimum 2 observations required
- price_usd or circulating_tokens is zero or negative — exclusive minimum enforced
- bins value exceeds 30 or is less than 1 — out-of-range bin count rejected
- More than 200 rows submitted — maxItems limit exceeded
- Missing required fields price_usd or circulating_tokens in any row object
- Payment of 0.01 USDC not fulfilled — x402 payment required before response

## How this service works

Token circulating market value — Distribution histogram: Distribution histogram for Token circulating market value. 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

A bounded distribution histogram report showing how circulating market cap values (price_usd × circulating_tokens) are distributed across the requested number of bins, including bin ranges and observation counts. The result is a deterministic calculation based solely on the supplied input rows — not a live market scan or investment recommendation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "bins": {
   "type": "integer",
   "default": 5,
   "maximum": 30,
   "minimum": 1
  },
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "price_usd",
     "circulating_tokens"
    ],
    "properties": {
     "price_usd": {
      "type": "number",
      "default": 2,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     },
     "circulating_tokens": {
      "type": "number",
      "default": 1000000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "price_usd": 2,
     "circulating_tokens": 1000000
    },
    {
     "price_usd": 2.2,
     "circulating_tokens": 1100000
    },
    {
     "price_usd": 2,
     "circulating_tokens": 1000000
    },
    {
     "price_usd": 2.2,
     "circulating_tokens": 1100000
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-circulating-market-cap-distribution-histogram-9a98991b/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)