# three.ws Bazaar Feed

> three.ws Bazaar Feed is a paid API for AI agents from three.ws, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-23).

Returns a paginated feed of new or active x402 micropayment API listings, or price-movement trends, from the three.ws bazaar marketplace.

## Facts

- Endpoint: POST https://three.ws/api/x402/bazaar-feed?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-23
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-bazaar-feed-d57990e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_7jby8NrqWlSnti4oYgrGS

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 three-ws-bazaar-feed-d57990e8 -d '<json body>'
```

Example prompt: Pull up to 25 new listings from the three.ws bazaar and tell me how active the marketplace has been — include the activity signal and daily average for the last 24 hours.

## When to prefer this

Use this endpoint when you need to discover, browse, or monitor listings on the three.ws x402 bazaar marketplace — especially for tracking new API submissions, checking marketplace activity signals, or watching price movements. It is the only feed-style endpoint for this specific marketplace and is distinct from general API directories or web search.

## Known failure modes

- Invalid filter enum value returns 400 or ignored
- Period string in wrong format (e.g. missing unit) may return default or error
- limit above 50 is clamped or rejected
- Payment not included causes 402 Payment Required response
- Marketplace has no listings matching filter, returning empty array with count 0
- Service downtime returns 5xx

## How this service works

Make a 3D AI agent from a selfie in 60 seconds. Drop one HTML tag to embed it on any website. Agents think on IBM watsonx.ai (Granite); optionally charge per chat with built-in micropayments.

## Output

Returns a JSON object with a count of matched listings, the applied limit and filter, an activity summary (new listings in 24h and 7d, daily average, confidence score, headline signal), an array of listing objects (id, name, price in USDC, first_seen timestamp), and a generated_at timestamp.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 50,
   "minimum": 1,
   "description": "Max listings to return (filter \"new\"/\"active\" only)."
  },
  "filter": {
   "enum": [
    "new",
    "active",
    "price_trends"
   ],
   "type": "string",
   "default": "new",
   "description": "\"new\"/\"active\" returns newest-listing feed (default \"new\"); \"price_trends\" returns price-movement monitor."
  },
  "period": {
   "type": "string",
   "default": "24h",
   "description": "Lookback window: <n><unit>, unit m/h/d/w (e.g. 24h, 7d). filter \"price_trends\" only."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 3,
  "limit": 10,
  "filter": "new",
  "activity": {
   "new_7d": 9,
   "signal": "active",
   "new_24h": 3,
   "headline": "3 new bazaar listings in 24 h",
   "confidence": 0.65,
   "daily_avg_7d": 1.29
  },
  "listings": [
   {
    "id": "http:https://svc.example/x402",
    "name": "Example Feed",
    "price": "0.001 USDC",
    "first_seen": "2026-06-28T00:00:00Z"
   }
  ],
  "generated_at": "2026-06-28T10:00:00Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-bazaar-feed-d57990e8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from three.ws](https://www.zero.xyz/host/three.ws/llms.txt)