# x402 Bazaar Rank – Firmographics

> x402 Bazaar Rank – Firmographics 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-23).

Returns a ranked list of x402 services filtered by firmographics tag, scored by real 30-day call volume and paying-wallet counts, with snapshot provenance receipt.

## Facts

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

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-firmographics-453b8281
```

Example prompt: Show me the top 25 firmographics services on the x402 bazaar ranked by paying wallets over the last 30 days, including their call counts and prices.

## When to prefer this

Choose this endpoint when you specifically need to discover and rank x402-protocol services within the firmographics domain using real on-chain usage signals (30-day calls and paying wallets). It is the right choice over generic web search or API directories when you need verifiable, payment-backed usage metrics and a cryptographic snapshot receipt for auditability. Prefer it over other x402 Bazaar Rank routes when the target category is firmographics/business-data enrichment specifically.

## Known failure modes

- No services match the firmographics tag — returns empty services array with count 0
- Payment not included or incorrect amount — returns HTTP 402 requiring USDC payment
- Snapshot index temporarily unavailable — may return stale or error response
- Malformed query parameters — returns 400 with validation error
- Worker cold-start latency causing timeout on first request

## How this service works

Use when an agent needs the top x402 services tagged 'firmographics'. Returns Retired route /in-firmographics: now serves the live /in-x402 ranking, the top 25 x402 services tagged 'x402' by 30-day unique paying wallets.

## Output

A JSON object containing a ranked array of up to 25 firmographics-tagged x402 services, each with name, network chain ID, 30-day call count, price in USD, resource URL, and 30-day payer count. Also includes total matched service count, the query parameters used, the route, a generatedAt timestamp, and a declaredBy field with snapshot hash and scoring revision for provenance.

## Request schema (JSON Schema)

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

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "generatedAt",
  "data"
 ],
 "properties": {
  "data": {
   "type": "string"
  },
  "generatedAt": {
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-bazaar-rank-firmographics-453b8281/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)