# x402 Bazaar Rank – In-Holders Route

> x402 Bazaar Rank – In-Holders Route is a paid API for AI agents from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev, paid per call via x402, $0.032/call, status unknown (last checked 2026-10-18).

Returns a ranked list of x402 services filtered to the 'holders' tag, scored by real 30-day call volume and paying-wallet counts, with a verifiable snapshot receipt.

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/in-holders?utm_source=zero.xyz
- Price: $0.032/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-bazaar-rank-in-holders-route-0335b2b5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_g3dejdEGtqH2iDOb-bj22

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 x402-bazaar-rank-in-holders-route-0335b2b5
```

Example prompt: Show me the top 25 holder-tagged x402 services ranked by paying wallets over the last 30 days, and include the snapshot receipt so I can verify the data.

## When to prefer this

Choose this endpoint when you need a pre-filtered, ranked view of x402 services specifically in the 'holders' category, backed by verifiable on-chain usage signals (real 30-day calls and paying wallets) rather than self-reported or static metadata. Prefer this over generic x402 discovery endpoints when you want holder-segment market intelligence with a cryptographic receipt for auditability.

## Known failure modes

- No services indexed under holders tag — returns empty services array with count 0
- Payment not provided or invalid — returns HTTP 402 requiring USDC payment
- Snapshot data stale or unavailable — may return outdated generatedAt timestamp
- Rate limiting on the worker — HTTP 429 response
- Malformed response if worker deployment is misconfigured — HTTP 500

## How this service works

An open index of the machine-to-machine (agent) economy. x402 routes: ranked discovery over the live x402 service market, every indexed service scored by real 30-day calls and paying-wallet bounds, with a receipt naming the snapshot hash and scoring revision. /economy routes, for Tempo MPP, Virtuals ACP, Olas, Masumi, ERC-8004 agent registries, Solana agent registries, Base agent contracts and MCP servers (Official MCP Registry): each protocol's published figures (agent or server counts, transactions or payment events; payers and USD volume only where the source publishes them: payers for x402 and Tempo MPP, USD volume for x402 and Virtuals ACP), each with its unit, window and source; units differ, so totals are not summed. L402 and per-service MPP listings are not covered.

## Output

A JSON object containing a ranked array of x402 services matching the 'holders' tag, each with service name, network (e.g. eip155:8453), 30-day call count, price in USD, resource URL, and number of paying wallets over 30 days. Also includes total matched count, query metadata, the route used, who declared the data, the generation timestamp, and a snapshot hash receipt for verifiability.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 25,
  "query": {
   "by": "payers",
   "op": "top",
   "limit": 25,
   "where": {
    "tag": "holders"
   }
  },
  "route": "/in-holders",
  "matched": 359,
  "services": [
   {
    "name": "forecast api",
    "network": "eip155:8453",
    "calls30d": 310,
    "priceUsd": 0.01,
    "resource": "https://api.example.com/forecast",
    "payers30d": 42
   }
  ],
  "declaredBy": "agent",
  "generatedAt": "2026-09-17T12:00:00.000Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-bazaar-rank-in-holders-route-0335b2b5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev](https://www.zero.xyz/host/x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/llms.txt)