# x402 Data API – Top APIs by Payers or Calls

> x402 Data API – Top APIs by Payers or Calls is a paid API for AI agents from data.kagurazaka.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-29).

Returns the top-ranked x402 APIs by distinct payers or total calls in the last 30 days, with price and uptime data, optionally filtered by category.

## Facts

- Endpoint: GET https://data.kagurazaka.dev/v1/market/top?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-29
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-data-api-top-apis-by-payers-or-calls-c2a17686
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eE3fBOfsvblAZRIa0qbX6

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-data-api-top-apis-by-payers-or-calls-c2a17686
```

Example prompt: Show me the top 10 x402 APIs in the 'llm & ai' category ranked by distinct payers over the last 30 days, including their prices and uptime.

## When to prefer this

Use this endpoint when you need a ranked leaderboard of x402 APIs by adoption (payers) or usage volume (calls), especially when you want to discover which APIs are most actively used in the x402 ecosystem. Prefer this over the uptime-ranked endpoint when popularity/demand is the primary signal, and over the origins endpoint when you want cross-seller rankings rather than a single seller's portfolio.

## Known failure modes

- Invalid 'by' value (not 'payers' or 'calls') returns a validation error
- limit out of range (< 1 or > 50) returns an error
- Invalid category enum value returns an error
- Payment failure or insufficient USDC balance returns 402
- Service unavailable returns 5xx

## How this service works

Data about the x402 market: the CDP Bazaar's listings, sellers, prices and categories, new listings and price changes from snapshots every 6 hours, uptime we measure for every paid listing, and x402 spending of any wallet and revenue of any seller on Base.

## Output

A JSON object containing the ranking metric used ('by': 'payers' or 'calls') and an array of results, each with the API resource URL, number of calls in the last 30 days, price in USD, number of distinct payers in the last 30 days, and measured uptime over 30 days.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "by": {
       "enum": [
        "payers",
        "calls"
       ],
       "type": "string",
       "description": "ranking (default payers)"
      },
      "limit": {
       "type": "integer",
       "description": "how many results (1-50, default 20)"
      },
      "category": {
       "enum": [
        "crypto & on-chain",
        "llm & ai",
        "web & search",
        "media",
        "finance",
        "social",
        "geo & weather",
        "developer tools",
        "other"
       ],
       "type": "string",
       "description": "only this category"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "by": {},
      "results": {}
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "by": "payers",
  "results": [
   {
    "resource": "https://api.example/v1/x",
    "calls_30d": 6956,
    "price_usd": 0.005,
    "payers_30d": 227,
    "uptime_30d": 1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-data-api-top-apis-by-payers-or-calls-c2a17686/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from data.kagurazaka.dev](https://www.zero.xyz/host/data.kagurazaka.dev/llms.txt)