# Bazaaro x402 Service Listing API

> Bazaaro x402 Service Listing API is a paid API for AI agents from bazaaro-agent.vercel.app, paid per call via x402, $0.001/call, status down (last checked 2026-09-15).

Lists all x402 pay-per-call services available on the Bazaaro aggregator, with optional filtering by maximum USDC price

## Facts

- Endpoint: POST https://bazaaro-agent.vercel.app/api/list
- Price: $0.001/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bazaaro-agent-vercel-app-27673986
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_KJIw5sZX1zx5116hP2ANB

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 bazaaro-agent-vercel-app-27673986 -d '<json body>'
```

Example prompt: Show me all the x402 services available on Bazaaro that cost less than $0.05 USDC so I can pick one to call.

## When to prefer this

Use this endpoint when an AI agent needs to discover what x402 pay-per-call services are available on the Bazaaro aggregator, especially when budget constraints apply. Prefer this over generic API directories when working within the x402 micropayment ecosystem or when you need USDC-denominated pricing details to decide which service to invoke next.

## Known failure modes

- Invalid maxUsdcPrice type (non-numeric) returns a 400 error
- Service cache is stale or unavailable, returning an empty items array
- Network timeout to Bazaaro backend causes 500 error
- Payment of $0.001 USDC not fulfilled via x402 protocol results in 402 Payment Required

## How this service works

Lists x402 services supported by Bazaaro with optional price filtering

## Output

Returns a JSON object with a list of x402 services, each containing the resource URL, USDC cost (numeric and display string), and service description, along with the total count and a cache timestamp indicating when the catalog was last refreshed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "maxUsdcPrice": {
   "type": "number",
   "description": "Optional maximum price filter in USDC (e.g., 1.0 to only show services under $1.00)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "success",
  "timestamp",
  "items",
  "totalCount"
 ],
 "properties": {
  "items": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "resource": {
      "type": "string",
      "description": "The x402 resource URL"
     },
     "costValue": {
      "type": "number",
      "description": "Numeric cost value in USDC"
     },
     "costDisplay": {
      "type": "string",
      "description": "Human-readable cost (e.g., '$0.10')"
     },
     "description": {
      "type": "string",
      "description": "Service description"
     },
     "costCurrency": {
      "type": "string",
      "description": "Currency (typically 'USDC')"
     }
    }
   },
   "description": "List of available x402 services"
  },
  "success": {
   "type": "boolean",
   "description": "Whether the request was successful"
  },
  "timestamp": {
   "type": "string",
   "description": "ISO timestamp of the response"
  },
  "totalCount": {
   "type": "number",
   "description": "Total number of services returned"
  },
  "cacheTimestamp": {
   "type": "string",
   "description": "When the service cache was last updated"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bazaaro-agent-vercel-app-27673986/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bazaaro-agent.vercel.app](https://www.zero.xyz/host/bazaaro-agent.vercel.app/llms.txt)