# x402 Bazaar Rank – Geolocation Services

> x402 Bazaar Rank – Geolocation Services 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 the top x402 geolocation-tagged services scored by 30-day call volume and unique paying wallets, with a verifiable snapshot receipt.

## Facts

- Endpoint: GET https://x402-bazaar-rank.x402-bazaar-rank-worker.workers.dev/in-geolocation?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-geolocation-services-8ff07ea4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_89zKsgsRdHbbqb7ejZtye

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-geolocation-services-8ff07ea4
```

Example prompt: Show me the top 25 geolocation services on the x402 bazaar ranked by the most unique paying wallets over the last 30 days, and include the snapshot hash so I can verify the data.

## When to prefer this

Use this endpoint when you need to discover and compare geolocation-specific x402 services by real market demand (actual calls and paying wallets) rather than self-reported popularity or static directories. Prefer it over generic API directories when you want cryptographically verifiable, timestamped market snapshots of geolocation APIs operating on the x402 payment protocol, especially when selecting a geolocation service for an autonomous agent that will pay per call.

## Known failure modes

- No geolocation-tagged services indexed — returns empty list with count 0
- Snapshot hash unavailable if index is being rebuilt — may return stale data
- Rate limit or payment failure at $0.032 USDC per call — 402 response if payment not provided
- Malformed query parameters — may return 400 or default behavior
- Index lag: 30-day metrics may be up to a few hours stale relative to generatedAt timestamp

## 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 the ranked list of geolocation-tagged x402 services (up to 25 or 100 entries), each with service name, network chain, 30-day call count, 30-day unique paying wallets, price in USD, and resource URL. Also includes the query parameters used, total matched service count, a snapshot hash for verification, and a timestamp indicating when the ranking 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": "geolocation"
   }
  },
  "route": "/in-geolocation",
  "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-geolocation-services-8ff07ea4/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)
