# x402 Bazaar Rank – Books Category

> x402 Bazaar Rank – Books Category is a paid API for AI agents from x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev, paid per call via x402, $0.008/call, status unknown (last checked 2026-10-17).

Returns ranked x402 service listings filtered to the 'books' tag, scored by real 30-day call volume and unique paying wallets, with a snapshot hash receipt.

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/in-books?utm_source=zero.xyz
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-bazaar-rank-books-category-b46b2442
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uitjJqAseyK1VcDBNriJR

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-books-category-b46b2442
```

Example prompt: Show me the top 25 book-related APIs on the x402 bazaar, ranked by how many paying wallets used them in the last 30 days — I want real usage data, not just listings.

## When to prefer this

Use this endpoint when you specifically want ranked discovery of x402 services in the books category, backed by real on-chain usage metrics (30-day calls and paying wallets) rather than self-reported or unverified listings. Prefer this over generic API directories when you need verifiable activity signals and a cryptographic receipt of the data snapshot for auditability.

## Known failure modes

- Empty result set if no book-tagged services are indexed
- Stale data if snapshot is older than expected refresh window
- Payment failure if USDC balance is insufficient (0.008 USDC required per call)
- Service unavailable if Cloudflare Worker is down
- Malformed response if snapshot hash or scoring revision is missing

## 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 count of returned results, the query parameters used (ranking criterion, operator, limit, tag filter), the route called, total matched services, an array of service objects each with name, network chain ID, 30-day call count, price in USD, resource URL, and 30-day unique payer count — plus metadata fields for who declared the data and when the snapshot was generated.

## 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": "books"
   }
  },
  "route": "/in-books",
  "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-books-category-b46b2442/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)
