# three.ws Market Categories

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

Returns a list of market categories with market cap, 24h volume, and price change data for each category.

## Facts

- Endpoint: GET https://three.ws/api/x402/market-categories?utm_source=zero.xyz
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/three-ws-market-categories-600c8ebc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Pna5yPsfPyfl3XlQYHHng

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-market-categories-600c8ebc
```

Example prompt: Can you pull up all the market categories from the three.ws agent marketplace, including their market caps and 24-hour volume and price change stats?

## When to prefer this

Use this endpoint when you need a structured overview of market categories available in the three.ws agent economy, including financial metrics like market cap and 24h volume. Prefer this over generic crypto market data APIs when specifically researching the three.ws marketplace segmentation or building dashboards for the agent-layer economy.

## Known failure modes

- Invalid or unsupported 'properties' filter value returns empty or error response
- Payment not included or insufficient USDC triggers 402 Payment Required
- Service unavailable returns 5xx error
- Malformed request body returns 400 Bad Request

## 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

A JSON object containing an array of market category entries, each with a unique category ID (e.g. 'artificial-intelligence'), human-readable name, total market cap in USD, 24h trading volume in USD, and percentage market cap change over the past 24 hours.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "properties": {
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "categories": [
   {
    "id": "artificial-intelligence",
    "name": "Artificial Intelligence",
    "market_cap": 48200000000,
    "volume_24h": 3900000000,
    "market_cap_change_24h": 2.1
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/three-ws-market-categories-600c8ebc/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)