# x402 Bazaar Rank – In-Stocks Discovery

> x402 Bazaar Rank – In-Stocks Discovery 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-09-18).

Returns a ranked list of stock-tagged x402 services sorted by real 30-day call volume and unique paying-wallet counts, with a signed snapshot receipt.

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/in-stocks
- Price: $0.008/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-bazaar-rank-in-stocks-discovery-248c24c0
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eNapXA_dfPAtdSPAYaMcc

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-stocks-discovery-248c24c0
```

Example prompt: Show me the top 25 stock-related x402 services ranked by paying wallets over the last 30 days, so I can find the most trusted paid stock data APIs on the x402 bazaar.

## When to prefer this

Choose this endpoint when you need a ranked, usage-weighted leaderboard of x402 services in the stocks category specifically, with verifiable provenance via snapshot hash. It is preferable over generic x402 discovery endpoints when you want real 30-day activity signals (calls and unique payers) rather than just static metadata listings. Ideal for agents building financial data pipelines that want to surface the most trusted and active paid stock APIs on the x402 network.

## Known failure modes

- No services indexed under the stocks tag — returns empty services array with count 0
- Snapshot hash unavailable if index is being rebuilt — may return stale or partial results
- Rate limiting at the Cloudflare Worker level if called too frequently without payment
- Payment failure (x402) if the $0.001 USDC micropayment is not properly attached, resulting in a 402 response
- Network/worker downtime on the workers.dev domain returning 5xx

## How this service works

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.

## Output

A JSON object containing: the total matched service count, the query parameters used (tag, operator, limit), the route called, and an array of ranked services each with name, network, 30-day calls, price in USD, resource URL, and 30-day unique payers — plus a declaredBy field, generatedAt timestamp, and a receipt with snapshot hash and scoring revision for auditability.

## 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": "stocks"
   }
  },
  "route": "/in-stocks",
  "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-stocks-discovery-248c24c0/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)
