# prediction-prices

> prediction-prices is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.015/call, status unknown (last checked 2026-09-15).

Returns a normalized implied-probability price/odds time series and momentum summary for one outcome of a Polymarket prediction market, identified by market ID, conditionId, or slug.

## Facts

- Endpoint: GET https://payai.agentstools.dev/prediction/prices
- Price: $0.015/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/prediction-prices-3828fee8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_rn2TCt4bZjsY0J9raG2kw

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 prediction-prices-3828fee8
```

Example prompt: Can you pull the implied probability history for the 'Yes' outcome on the Polymarket market with slug 'will-btc-hit-100k-in-2025' over the past week, and tell me the current price, how much it's changed, and which direction it's trending?

## When to prefer this

Use this endpoint when you need historical implied-probability data and momentum analytics for a single Polymarket prediction market outcome, identified by numeric ID, 0x conditionId, or slug. Prefer it over generic market data APIs when you specifically need normalized probability time series (not raw token prices) and a precomputed momentum summary (change, trend, min/max) in one call.

## Known failure modes

- Unknown or invalid market ID/slug returns a 404 or empty result
- Ambiguous outcome name not matching any outcome returns an error or defaults to index 0
- Unsupported venue value returns a validation error
- Interval or fidelity combination with no available data returns empty series
- Payment not included or insufficient USDC triggers 402 Payment Required

## How this service works

Odds/price history for ONE outcome of a prediction market (by id, 0x conditionId or slug): a normalized implied-probability time series plus a momentum summary — change, percent change, min/max, current and trend.

## Output

Returns a normalized implied-probability time series for the specified outcome (e.g. Yes/No), along with a momentum summary including: current price, absolute and percent change over the interval, historical minimum and maximum, and a trend label — giving a full picture of how market sentiment has shifted.

## 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"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "id"
     ],
     "properties": {
      "id": {
       "type": "string",
       "description": "Market/event id: numeric id, 0x conditionId, market-slug or event-slug"
      },
      "venue": {
       "enum": [
        "polymarket"
       ],
       "type": "string",
       "description": "Venue (default polymarket)"
      },
      "outcome": {
       "type": "string",
       "description": "Outcome name (e.g. Yes/No) or index; default index 0 (usually Yes)"
      },
      "fidelity": {
       "type": "integer",
       "minimum": 1,
       "description": "Resolution in minutes (default per interval)"
      },
      "interval": {
       "enum": [
        "1h",
        "6h",
        "1d",
        "1w",
        "1m",
        "max"
       ],
       "type": "string",
       "description": "History window (default 1d)"
      }
     }
    }
   },
   "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/prediction-prices-3828fee8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)