# x402.forgemesh.io Swag Categories

> x402.forgemesh.io Swag Categories is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Returns a category-first view of the x402swag.com storefront — apparel, drinkware, stickers, crew-necks, v-necks — with items and price ranges, plus the store's full purchase flow options; supports optional category filtering.

## Facts

- Endpoint: POST https://x402.forgemesh.io/swag-categories
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-forgemesh-io-swag-categories-9feb3cc6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X2LeY4sNpgQa1nTIc1Fbw

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-forgemesh-io-swag-categories-9feb3cc6 -d '<json body>'
```

Example prompt: Show me all the drinkware available on x402swag.com, including what items are in that category and their price ranges, and explain how I'd actually buy something.

## When to prefer this

Prefer this endpoint when you want a category-organized view of the x402swag.com storefront rather than a flat product list, especially when you know which category you want to filter on. Use it to discover what's available under a specific product type (e.g. just drinkware) along with the purchase flow details needed to actually complete a transaction. It complements the broader catalog endpoints by offering category-first navigation.

## Known failure modes

- Invalid category value returns an error or empty result — only 'apparel', 'drinkware', 'stickers', 'crew-necks', 'v-necks' are valid
- Payment of $0.05 USDC not settled correctly results in 402 Payment Required response
- Upstream x402swag.com catalog unavailable causes stale or empty data
- Malformed request body causes a 400-level error

## How this service works

Category-first view of the x402swag.com storefront: apparel, drinkware, stickers, crew-necks, and v-necks, each with its items and price ranges, plus the store's real purchase flow (free browse/checkout, dynamic x402/card settlement, or the store's $0.05 one-call shortcut). Optional category filter.

## Output

A structured JSON response with product categories (or a single filtered category) from x402swag.com, each containing its items with price ranges, plus a description of the store's purchase flow options: free browse/checkout, dynamic x402/card settlement, or the $0.05 one-call shortcut.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "category": {
   "type": "string",
   "description": "Optional: apparel, drinkware, stickers, crew-necks, v-necks"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "items": [
   {
    "id": 67,
    "title": "x402 Die-Cut Sticker Black, Letterform Shape Cut, White Outline, Vinyl Laptop Sticker",
    "handle": "x402-die-cut-sticker-black-letterform-shape-cut-white-outline-vinyl-laptop-sticker",
    "category": "stickers",
    "description": "x402 in solid black with a white fusing outline — cut to the shape of the word. Reads on any surface.",
    "price_range": {
     "max": 7.99,
     "min": 3.99
    },
    "variant_count": 5
   }
  ],
  "category": "stickers",
  "how_to_buy": {
   "site": "https://x402swag.com",
   "browse": "Free — GET /api/products and GET /api/collections list every item and category with no payment required.",
   "cart_and_checkout": "Free to build — POST /api/cart/add and POST /api/checkout assemble an order and return an order token.",
   "payment_dynamic_order": "POST /api/orders/{token}/pay settles via x402 USDC on Base at a dynamic cart-based price; POST /api/orders/{token}/stripe pays by card.",
   "x402_one_call_shortcut": {
    "route": "GET /api/agent/catalog",
    "price_usd": 0.05
   }
  },
  "total_items": 13
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-forgemesh-io-swag-categories-9feb3cc6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)