# Polymarket Odds Movers

> Polymarket Odds Movers is a paid API for AI agents from api.hergertsynthora.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns the top prediction market contracts on Polymarket ranked by the largest price movement within a configurable time window

## Facts

- Endpoint: POST https://api.hergertsynthora.com/v1/polymarket-odds-movers
- 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-odds-movers-fc079088
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xaf6gXYXbItw2beKBgjmg

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-odds-movers-fc079088 -d '<json body>'
```

Example prompt: Show me the top 20 Polymarket markets with the biggest odds moves over the last 24 hours, only including markets with at least $10,000 in volume.

## When to prefer this

Use this endpoint when you need real-time ranked intelligence on which Polymarket prediction markets are moving fastest, rather than fetching all markets or a static snapshot. Prefer it over generic Polymarket API calls when you want pre-filtered, sorted, and enriched mover data with volume and liquidity context in a single call, saving agent-side computation.

## Known failure modes

- Invalid window value (not 1h, 24h, or 1wk) returns a validation error
- limit out of range (below 1 or above 50) causes a 400 error
- Polymarket API unavailability upstream may cause timeouts or degraded results
- min_volume too high may return an empty movers list with count 0
- Payment failure via x402 protocol returns 402 before the endpoint is reached

## How this service works

Polymarket odds movers: active markets ranked by biggest price swing in the last 1h / 24h / 1wk (window param), with yes price, change and direction, best bid/ask, spread, 24h volume, liquidity and end date. The momentum signal prediction bots scan before entering a market. No charge on service failure. Ed25519-signed. $0.10 USDC per call via x402 on Base. Free trial: 3 calls per wallet with header X-WALLET.

## Output

A JSON object containing a ranked list of up to 50 Polymarket prediction market contracts sorted by absolute price change. Each market entry includes the slug, question text, direction of move (up/down), new yes price, price change delta, spread, liquidity in USD, 24h volume in USD, and end date. The response also includes aggregate stats: total markets scanned, count of up-movers and down-movers, the time window used, and the single largest absolute move observed.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "Max markets (1-50, default 15)"
  },
  "window": {
   "type": "string",
   "description": "1h | 24h | 1wk (default 24h)"
  },
  "min_volume": {
   "type": "number",
   "description": "Min 24h volume USD (default 10000)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "ok": true,
  "niche": "polymarket_odds_movers",
  "result": {
   "count": 15,
   "movers": [
    {
     "slug": "...",
     "change": 0.21,
     "spread": 0.01,
     "end_date": "...",
     "question": "...",
     "direction": "up",
     "yes_price": 0.63,
     "liquidity_usd": 80000,
     "volume_24h_usd": 150000
    }
   ],
   "window": "24h",
   "up_count": 9,
   "down_count": 6,
   "markets_scanned": 400,
   "biggest_move_abs": 0.45
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-odds-movers-fc079088/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hergertsynthora.com](https://www.zero.xyz/host/api.hergertsynthora.com/llms.txt)