# Token Circulating Market Cap Rank

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

Ranks a list of token observations by circulating market capitalization (price × supply), returning a deterministic record ranking report.

## Facts

- Endpoint: POST https://market.datapackvibe.com/x402/assistant-bx-token-market-cap-rank?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-rank-44913e66
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pmvstIJ4Tdgm6UmqGhLgo

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-rank-44913e66 -d '<json body>'
```

Example prompt: I have four token snapshots — Token A at $2.00 with 1,000,000 circulating supply, Token B at $2.20 with 1,100,000, Token C at $1.50 with 2,000,000, and Token D at $3.00 with 500,000 — can you rank them by circulating market cap?

## When to prefer this

Use this endpoint when you have a known set of token price and supply observations and need a fast, deterministic market cap ranking without calling a live market data API. It is ideal for offline analysis, backtesting, snapshot comparisons, or situations where you already have the price and circulating supply data and simply need them ranked by market capitalization. Prefer this over live market data endpoints when determinism and cost predictability ($0.01 per call) matter more than real-time accuracy.

## Known failure modes

- Fewer than 2 rows submitted — minimum of 2 observations required
- price_usd or circulating_tokens set to zero or negative — exclusiveMinimum constraint violated
- More than 200 rows submitted — maxItems limit exceeded
- price_usd or circulating_tokens exceeds maximum value of 1e16 — value out of range
- Malformed JSON body — request rejected before computation

## How this service works

Token circulating market value — Record ranking: Record ranking 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 record ranking report.

## Output

A bounded record ranking report listing the submitted token observations ordered by their computed circulating market capitalization (price_usd × circulating_tokens), with rank positions assigned deterministically based on the supplied input data. No live market data, external feeds, or trade recommendations are included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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-rank-44913e66/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)