# Polymarket Markets by Category Tag

> Polymarket Markets by Category Tag is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns Polymarket prediction market listings filtered by a category tag ID, including questions, outcome prices, and trading volume.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-markets-by-tag
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-markets-by-category-tag-d5bf0e32
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_riusgnWUsI8m4dowU1IxS

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 polymarket-markets-by-category-tag-d5bf0e32 -d '<json body>'
```

Example prompt: Pull all the current Polymarket prediction markets in the politics category — I want to see the questions, outcome prices, and trading volume for each one.

## When to prefer this

Use this endpoint when you need to browse or monitor Polymarket prediction markets organized by topic category (politics, crypto, sports, etc.) and want free Gamma data without direct Polymarket API integration. Pair with the polymarket-tags endpoint to discover valid tag IDs first. Prefer this over scraping Polymarket directly or using unfiltered market dumps when you need category-scoped results.

## Known failure modes

- Invalid or unknown tag ID returns empty results or an error
- Tag ID not found — use polymarket-tags endpoint first to discover valid IDs
- API returns stale data if Polymarket Gamma feed is delayed
- Payment failure (x402) if USDC balance is insufficient for the $0.05 call
- Malformed POST body or wrong bodyType causes 400-level error

## How this service works

Polymarket markets filtered by category tag id (politics, crypto, sports, etc.): question, outcome prices, volume. Free Polymarket Gamma data. Use polymarket-tags to discover tag ids.

## Output

A list of Polymarket prediction markets matching the specified category tag, each including the market question text, outcome option prices (probabilities), and cumulative trading volume.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-markets-by-category-tag-d5bf0e32/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)