# Polymarket Markets Feed via AgentUtility

> Polymarket Markets Feed via AgentUtility is a paid API for AI agents from x402.agentutility.ai, paid per call via x402, $0.005/call, status unknown (last checked 2026-09-15).

Fetches live Polymarket prediction market data including YES/NO prices, liquidity, volume, and end dates with optional filtering by category, tag, query, or minimum liquidity

## Facts

- Endpoint: POST https://x402.agentutility.ai/polymarket-markets
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-markets-feed-via-agentutility-1a29b30a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_M565qYNB2P6EJXDmF8ibW

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-feed-via-agentutility-1a29b30a -d '<json body>'
```

Example prompt: Pull the top active Polymarket prediction markets about the 2024 US election with at least $50k liquidity and show me the current YES/NO prices and implied probabilities.

## When to prefer this

Choose this endpoint when you need live Polymarket prediction market data including current YES/NO prices and liquidity metrics without executing any trades. Prefer it over scraping Polymarket directly for structured, filtered, agent-ready data. Best suited for forecasting research, probability tracking, arbitrage signal detection, and market monitoring workflows where real-time odds from Polymarket's gamma-api are needed in a programmatic form.

## Known failure modes

- Gamma API unavailable or rate-limited — returns error with no market data
- No markets match the supplied filters — returns empty result set
- Invalid or unrecognized category/tag value — may return empty or unfiltered results
- Minimum liquidity filter set too high — returns no results if no markets qualify
- Payment failure via x402 protocol — request not processed

## How this service works

Polymarket markets / prediction market data / Polymarket API / list active prediction markets / crypto-settled betting odds / event odds / Polymarket browse. Pulls live Polymarket markets from gamma-api with filter by category, tag, free-text query, minimum liquidity. Returns market question, current YES/NO outcome prices (implied probabilities), 24-hr volume, liquidity, end date. DATA-ONLY — no trading. Useful for agent forecasting research and arbitrage detection.

## Output

Returns a list of active Polymarket prediction markets, each containing the market question, current YES and NO outcome prices (as implied probabilities between 0 and 1), 24-hour trading volume, total liquidity, and market end/resolution date. Results are filtered according to any supplied category, tag, free-text query, or minimum liquidity parameters.

## 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": {
      "tag": {
       "type": "string",
       "description": "Polymarket tag slug filter, passed through to upstream."
      },
      "limit": {
       "type": "number",
       "description": "1-100. Default 20."
      },
      "order": {
       "enum": [
        "volume24hr",
        "liquidity",
        "endDate",
        "startDate"
       ],
       "type": "string",
       "description": "Sort field."
      },
      "query": {
       "type": "string",
       "description": "Free-text filter applied to question + description + slug. Case-insensitive substring match against the current page."
      },
      "active": {
       "type": "boolean",
       "description": "Default true. Pass false to include inactive markets."
      },
      "closed": {
       "type": "boolean",
       "description": "Default false. Pass true to include closed markets."
      },
      "offset": {
       "type": "number",
       "description": "Pagination offset."
      },
      "category": {
       "type": "string",
       "description": "Filter by Polymarket category (substring match, e.g. 'Sports', 'Crypto', 'Politics')."
      },
      "ascending": {
       "type": "boolean",
       "description": "Sort direction."
      },
      "min_liquidity": {
       "type": "number",
       "description": "Minimum liquidity in USD."
      }
     }
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "count": {
       "type": "integer"
      },
      "markets": {
       "type": "array",
       "items": {
        "type": "object",
        "properties": {
         "id": {
          "type": "string"
         },
         "slug": {
          "type": "string"
         },
         "end_date": {
          "type": "string"
         },
         "outcomes": {
  
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 10,
  "markets": [
   {
    "id": "12345",
    "slug": "will-x-happen-by-y",
    "end_date": "2026-12-31T12:00:00Z",
    "outcomes": [
     "Yes",
     "No"
    ],
    "question": "Will X happen by Y?",
    "liquidity_usd": 12000,
    "outcome_prices": [
     0.42,
     0.58
    ],
    "volume_24hr_usd": 50000
   }
  ],
  "attribution": "Data: Polymarket gamma-api. https://polymarket.com"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-markets-feed-via-agentutility-1a29b30a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.agentutility.ai](https://www.zero.xyz/host/x402.agentutility.ai/llms.txt)