# Token Circulating Supply Fraction — Adjacent Period Changes

> Token Circulating Supply Fraction — 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-15).

Calculates period-over-period changes in the circulating supply fraction (circulating/total tokens) for a sequence of token observations.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-circulating-period-changes?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-circulating-supply-fraction-adjacent-period-changes-f85c1317
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_NiaPQyd2OPlMkz1VNzdaC

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-supply-fraction-adjacent-period-changes-f85c1317 -d '<json body>'
```

Example prompt: I have four consecutive token snapshots — 1,000,000 circulating out of 2,000,000 total, then 1,100,000 out of 2,200,000, then 1,000,000 out of 2,000,000, then 1,100,000 out of 2,200,000 — can you calculate the adjacent period changes in the circulating supply fraction for me?

## When to prefer this

Choose this endpoint when you need a fast, deterministic, cheap ($0.01 USDC) calculation of how a token's circulating supply fraction has changed between consecutive observations. Ideal for tokenomics dashboards, vesting schedule analysis, or supply health monitoring where you already have the raw circulating and total token counts and just need the period-over-period delta computed reliably. Not suited for live market data retrieval or trade signal generation.

## Known failure modes

- Fewer than 2 rows provided — minimum input requirement not met
- total_tokens set to 0 or missing — division by zero or schema validation error
- Array exceeds 200 items — maxItems constraint violated
- circulating_tokens exceeds total_tokens — logically inconsistent input may produce unexpected fractions
- Non-numeric values in circulating_tokens or total_tokens fields — schema validation failure

## How this service works

Token circulating supply fraction — Adjacent period changes: Adjacent period changes for Token circulating supply fraction. 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 detailing the adjacent period changes in the circulating supply fraction (circulating_tokens / total_tokens) for each consecutive pair of input observations. The output is a deterministic calculation result, not a live scan or trade recommendation.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "rows": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "circulating_tokens",
     "total_tokens"
    ],
    "properties": {
     "total_tokens": {
      "type": "number",
      "default": 2000000,
      "maximum": 10000000000000000,
      "minimum": 0,
      "exclusiveMinimum": 0
     },
     "circulating_tokens": {
      "type": "number",
      "default": 1000000,
      "maximum": 10000000000000000,
      "minimum": 0
     }
    },
    "additionalProperties": false
   },
   "default": [
    {
     "total_tokens": 2000000,
     "circulating_tokens": 1000000
    },
    {
     "total_tokens": 2200000,
     "circulating_tokens": 1100000
    },
    {
     "total_tokens": 2000000,
     "circulating_tokens": 1000000
    },
    {
     "total_tokens": 2200000,
     "circulating_tokens": 1100000
    }
   ],
   "maxItems": 200,
   "minItems": 2
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/token-circulating-supply-fraction-adjacent-period-changes-f85c1317/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)