# Lumen Agent Utilities – Polymarket Prediction Market Data

> Lumen Agent Utilities – Polymarket Prediction Market Data is a paid API for AI agents from lumenworks-x402-decoder.onrender.com, paid per call via x402, $0.001/call, status unknown (last checked 2026-10-11).

Fetches read-only Polymarket prediction market data, either by keyword search or top markets ranked by 24-hour trading volume, returning questions, outcome probabilities, volume, liquidity, and end dates.

## Facts

- Endpoint: POST https://lumenworks-x402-decoder.onrender.com/v1/polymarket/markets?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/lumen-agent-utilities-polymarket-prediction-market-data-56886d79
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_fsB3gDYtafMum7ktgdQAM

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 lumen-agent-utilities-polymarket-prediction-market-data-56886d79 -d '<json body>'
```

Example prompt: What are the top prediction markets on Polymarket right now by 24-hour volume, and what are the current implied probabilities for each outcome?

## When to prefer this

Use this endpoint when you need live, read-only Polymarket prediction market data including implied probabilities, liquidity, and volume rankings. Prefer it over manually scraping Polymarket or using general web search when you need structured, machine-readable probability data for specific events or want to surface the most actively traded markets. Ideal for agents doing financial research, political analysis, sports forecasting, or any scenario requiring crowd-sourced probability estimates.

## Known failure modes

- No markets found matching the search query — returns empty markets array
- Polymarket Gamma API upstream outage — may return an error or empty response
- Malformed or overly broad query returning irrelevant markets
- Payment not fulfilled — 402 response requiring x402 micropayment
- Rate limiting or network timeout from the upstream Polymarket API

## How this service works

Read-only Polymarket prediction-market data: search by {query} or top active markets by 24h volume. Returns question, outcomes with implied probabilities, 24h/total volume, liquidity, end date, URL. …

## Output

A JSON object containing a list of prediction markets, each with the market question, active/closed status, end date, list of outcomes with implied probabilities, 24-hour volume, total volume, liquidity, market URL, and slug. Also includes the data source attribution and the query used.

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "note": "Top active markets by 24h volume. Read-only data; not financial advice.",
  "query": null,
  "source": "Polymarket Gamma API",
  "markets": [
   {
    "url": "https://polymarket.com/market/dota2-ty-ts8-2026-10-10-game2",
    "slug": "dota2-ty-ts8-2026-10-10-game2",
    "active": true,
    "closed": false,
    "endDate": "2026-10-10T14:30:00Z",
    "outcomes": [
     {
      "outcome": "Team Yandex",
      "probability": 0.987
     },
     {
      "outcome": "Team Spirit",
      "probability": 0.013
     }
    ],
    "question": "Dota 2: Team Yandex vs Team Spirit - Game 2 Winner",
    "liquidity": 94999.5371,
    "volume24h": 1246835.994284999,
    "volumeTotal": 1242546.046738001
   },
   {
    "url": "https://polymarket.com/market/will-luiz-incio-lula-da-silva-win-the-2026-brazilian-presidential-election",
    "slug": "will-luiz-incio-lula-da-silva-win-the-2026-brazilian-presidential-election",
    "active": true,
    "closed": false,
    "endDate": "2026-10-05T03:59:00Z",
    "outcomes": [
     {
      "outcome": "Yes",
      "probability": 0.115
     },
     {
      "outcome": "No",
      "probability": 0.885
     }
    ],
    "question": "Will Luiz Inácio Lula da Silva win the 2026 Brazilian presidential election?",
    "liquidity": 1469356.5492,
    "volume24h": 894261.5656739997,
    "volumeTotal": 21990309.847675
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/lumen-agent-utilities-polymarket-prediction-market-data-56886d79/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from lumenworks-x402-decoder.onrender.com](https://www.zero.xyz/host/lumenworks-x402-decoder.onrender.com/llms.txt)