# agent402.tools X402 Market Pulse

> agent402.tools X402 Market Pulse is a paid API for AI agents from agent402.tools, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-13).

Returns live cross-provider x402 ecosystem market sentiment, ranking top sellers by revenue, unique buyers, or raw call volume with on-chain activity data

## Facts

- Endpoint: GET https://agent402.tools/api/x402-market-pulse
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agent402-tools-x402-market-pulse-80a4bb8e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_iq0kp-gDMTvOeVhQU14B1

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 agent402-tools-x402-market-pulse-80a4bb8e
```

Example prompt: Show me the top 20 x402 providers right now ranked by number of distinct buyers — I want to see who has the most reach in the ecosystem, not just the highest revenue.

## When to prefer this

Use this endpoint when you need a real-time, on-chain-verified leaderboard of x402 API providers — especially when you want to benchmark a specific provider's standing, understand ecosystem revenue distribution, or identify which APIs have the broadest buyer reach. Prefer the 'buyers' sort for reach analysis vs 'usd' for whale-adjusted revenue vs 'calls' for raw volume signals.

## Known failure modes

- Invalid sort value (not usd/buyers/calls) returns 400
- top parameter outside 1-50 range returns 400 or clamped value
- On-chain data lag may cause brief staleness during high network congestion
- Payment failure (insufficient USDC balance) results in 402 response blocking data access

## How this service works

Live cross-provider x402 market sentiment. topProviders: the top x402 sellers ecosystem-wide, ranked by REAL on-chain activity (Agent402 included and flagged isSelf:true). Pick the lens with sort: 'usd' (revenue, default - whale-skewable), 'buyers' (distinct paying wallets - broadest adoption/reach), or 'calls' (raw volume). Every row carries all metrics plus callsPerBuyer (intensity), so revenue and actual ecosystem usage are both visible.

## Output

A ranked list of top x402 sellers ecosystem-wide, each with on-chain-verified metrics for the chosen lens (revenue in USD, distinct paying wallets, or raw call count), plus agent402's own row flagged as isSelf:true even if it falls outside the requested top-N cutoff.

## 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": {
      "top": {
       "type": "integer",
       "description": "How many top providers to return (1-50, default 10). Agent402's own row is always included at its true rank even if it falls outside this many."
      },
      "sort": {
       "enum": [
        "usd",
        "buyers",
        "calls"
       ],
       "type": "string",
       "description": "Ranking lens: usd=revenue (default), buyers=distinct paying wallets (reach), calls=raw volume"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": "string"
      },
      "window": {
       "type": "string"
      },
      "sortedBy": {
       "type": "string"
      },
      "ecosystem": {
       "type": "object",
       "properties": {
        "toolsIndexed": {
         "type": "integer"
        },
        "sellersIndexed": {
         "type": "integer"
        },
        "toolsCapPerSeller": {
         "type": "integer"
        }
       }
      },
      "topProviders": {
       "type": "array",
       "items": {
        "type": "object"
       }
      },
      "topToolCategories": {
       "type": "array",
       "items": {
        "type": "object"
       }
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "asOf": "2026-07-12T00:00:00.000Z",
  "window": "last 24h",
  "sortedBy": "usd",
  "ecosystem": {
   "toolsIndexed": 33779,
   "sellersIndexed": 1479,
   "toolsCapPerSeller": 50
  },
  "topProviders": [
   {
    "rank": 1,
    "calls": 353970,
    "buyers": 163,
    "homepage": "https://blockrun.ai",
    "provider": "blockrun.ai",
    "usdSettled": 294.55,
    "callsPerBuyer": 2171
   }
  ],
  "topToolCategories": [
   {
    "tools": 3353,
    "category": "crypto",
    "sellersOffering": 446
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agent402-tools-x402-market-pulse-80a4bb8e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)