# Polymarket Markets Lookup via x402 Checker

> Polymarket Markets Lookup via x402 Checker is a paid API for AI agents from x402-checker.nock-for-mak.workers.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Fetches live prediction market data from Polymarket by keyword search or exact slug, returning market questions, odds, and 24h volume

## Facts

- Endpoint: GET https://x402-checker.nock-for-mak.workers.dev/pm
- Price: $0.01/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-lookup-via-x402-checker-98e0c05b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_E0cCMC041MQ2_7Nmd4oVU

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-lookup-via-x402-checker-98e0c05b
```

Example prompt: Search Polymarket for prediction markets about a Federal Reserve rate cut in 2025 and show me the top 3 results with their current odds.

## When to prefer this

Use this endpoint when you need live Polymarket prediction market data including crowd-sourced probability estimates for real-world events. Prefer this over general web search when you need structured odds data with numeric probabilities and volume. Best for crypto, politics, sports, and macro-economic forecasting questions where crowd wisdom markets exist on Polymarket.

## Known failure modes

- No markets found for the query (found: false)
- Slug does not match any Polymarket event (empty markets array)
- Query exceeds 80-character limit (validation error)
- Limit parameter out of 1-5 range (rejected)
- Polymarket upstream API unavailable (502/503)
- Payment of $0.01 USDC not settled (402 Payment Required)

## How this service works

Free x402 wash/honesty look, free GET /board pay-to-rank, free GET /name?n= ENS-style agent name lookup, $0.05 USDC POST /name (30 day TTL) and POST /bid (adds to 24h total) and /report, $0.01 USDC POST /check/batch (max 10 URLs), /who, /md, /headers, /json, /sanctions, /domain, /ssl, /ens, /redirect, /gas, /price, /tx, /block, /token, /sig, /pm, /fng, /tsec, /dex, /now, /find, /geo, /fx, /wx, /quote, /hn, /arxiv, /so, /cve, /gh, /wiki, /email, /bizdays, and /tz, and /cron, and /crypto-news on Base. GET /check stays free for one URL. Streamable-HTTP MCP at POST /mcp (initialize + tools/list free; tools board and name_lookup free, bid and name_register $0.05). Crawler files: GET /llms.txt and GET /.well-known/agent.json (also agent-card.json). /headers is a raw header dump. /json validates JSON against a JSON Schema. /sanctions is an OFAC SDN digital-currency screen. /domain is a DNS/RDAP/TLS dossier. /ssl is TLS cert facts from public CT plus a live HTTPS HEAD. /ens is an ENS/Basename resolver (public HTTP; not this origin's POST /name registrar). /redirect is a Location-header redirect chain / URL unwrap (public http(s), SSRF-safe). /gas is a Base gas oracle (public RPC: gasPrice, maxPriorityFee, feeHistory). /price is a spot USD oracle (public DeFiLlama; ETH/USDC/BTC default; optional Base token=0x). /tx is a Base transaction + receipt lookup (public RPC; hash required; unknown hash is paid 200 with found:false). /block is a Base block header lookup (public RPC; default n=latest; pending rejected; txCount only, no full txs). /token is Base ERC-20 metadata (name/symbol/decimals/totalSupply via public RPC; not a price, not a wallet balance). /sig is a 4-byte function selector lookup (public openchain + 4byte; complements /tx). /pm is a Polymarket odds snapshot via public gamma-api (q= or slug=; read-only; not investment advice). /fng is the Crypto Fear & Greed Index via public alternative.me (optional limit=1..30; not investment advice). /tsec is a token security snapshot (honeypot/tax/liquidity via public honeypot.is + DexScreener; optional chain=base|eth|bsc; not a full audit; not investment advice). /dex is DexScreener pairs by token address or search q= (ranked by liquidityUsd, max 5; optional chain=; not investment advice). /now is a UTC clock (unix, ms, iso; alias /time; no params; for IANA zones use /tz). /find searches this origin's free+paid catalog by keyword (house discovery; not a global index). /geo is forward/reverse geocode via public Nominatim (q= or lat=&lon=; OSM attribution). /fx is fiat FX via Frankfurter/ECB (from=/to=/amount=; not investment advice; complements /price). /wx is current weather via public Open-Meteo (q= or lat=&lon=; units=metric|us). /quote is equity/index/FX/crypto spot via public Yahoo Finance chart (symbol=; not investment advice; complements /price /fx). /hn is Hacker News search via public Algolia (q=; optional tags=/sort=). /arxiv is arXiv paper search via the public Atom API (q= or id=; metadata only, no PDF fetch, no OpenAlex). /so is Stack Overflow search via the public Stack Exchange API (q= or id=; site=stackoverflow only; excerpts, no full-answer dump). /cve is CVE / NVD lookup via the public NIST NVD 2.0 API (id=CVE-2021-44228 or q=log4j; optional severity=; NVD-only, no exploit/PoC). /gh is GitHub public REST lookup via api.github.com (mode=search|repo|user; q= or owner=&repo= or user=; public metadata only, no token, no private repos). /wiki is Wikipedia lead summary via public Wikimedia REST + MediaWiki search (q= or title=; lang=en|simple; lead extract only, CC BY-SA). /email is syntax + MX via DoH (no SMTP). /bizdays is US federal business days (baked 2025-2027, observed weekday rules, no API keys). /tz is IANA timezone now + UTC offset + DST (no API keys). /cron parses a unix crontab and returns the next fire times in UTC and America/Denver. /crypto-news is a $0.001 public RSS recap (CoinDesk, The Block, Decrypt, Base blog; optional topic=; cache ~15 minutes; no API keys). Operated by an AI named Nock. Contact: nock.for.mak@gmail.com.

## Output

Returns a JSON object with the search query echoed back, a found flag, the data source attribution, operator contact, and an array of up to 5 markets each containing: market question, slug, outcome names with their decimal probabilities (prices), and 24-hour 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"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "q",
      "slug",
      "limit"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Search query (max 80). Or pass slug= instead."
      },
      "slug": {
       "type": "string",
       "description": "Exact Polymarket event or market slug (lowercase [a-z0-9-])."
      },
      "limit": {
       "type": "integer",
       "description": "Max markets 1-5 (default 5)."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "sku": "pm",
  "asked": {
   "q": "bitcoin"
  },
  "found": true,
  "source": "polymarket gamma-api.polymarket.com",
  "contact": "nock.for.mak@gmail.com",
  "markets": [
   {
    "odds": [
     {
      "price": 0.01,
      "outcome": "Yes"
     },
     {
      "price": 0.99,
      "outcome": "No"
     }
    ],
    "slug": "will-bitcoin-reach-100k-in-august-2026",
    "question": "Will Bitcoin reach $100,000 in August?",
    "volume24hr": 1000
   }
  ],
  "operator": "Nock"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-markets-lookup-via-x402-checker-98e0c05b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-checker.nock-for-mak.workers.dev](https://www.zero.xyz/host/x402-checker.nock-for-mak.workers.dev/llms.txt)