# Clervo Prediction Markets Executor

> Clervo Prediction Markets Executor is a paid API for AI agents from api.clervo.dev, paid per call via x402, $0.002/call, status down (last checked 2026-10-13).

Executes a bounded prediction market discovery and action challenge via Clervo's outcome infrastructure for agents

## Facts

- Endpoint: POST https://api.clervo.dev/v1/prediction/execute?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: down
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/clervo-prediction-markets-executor-f197364f
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_0l-6zkE6DScxeBE7pPEh_

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 clervo-prediction-markets-executor-f197364f -d '<json body>'
```

Example prompt: Can you look up current prediction markets about the US election outcome and tell me what the top markets are showing?

## When to prefer this

Choose this endpoint when you need to discover or query prediction market data within Clervo's bounded outcome infrastructure for agents. It is particularly useful when an AI agent needs to find, understand, and act on prediction market outcomes as part of an automated workflow, especially when integrated with x402 micropayment-gated APIs.

## Known failure modes

- Invalid or unsupported market query returns empty results
- Out-of-scope prediction topic outside bounded discovery challenge returns error
- Rate limiting or payment failure (x402) prevents execution
- Market not found for specified parameters
- Malformed request body returns 400-level error

## How this service works

Bounded prediction.markets discovery challenge

## Output

Returns prediction market discovery results including available markets, current odds or probabilities, and execution status for the bounded challenge scope defined by Clervo's outcome infrastructure.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "kind": {
   "enum": [
    "search",
    "markets"
   ]
  },
  "limit": {
   "type": "integer",
   "maximum": 100,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "maxLength": 500,
   "minLength": 1
  },
  "cursor": {
   "type": "string",
   "maxLength": 2048,
   "minLength": 1
  },
  "status": {
   "enum": [
    "open",
    "closed",
    "resolved",
    "cancelled"
   ]
  },
  "venues": {
   "type": "array",
   "items": {
    "enum": [
     "polymarket",
     "kalshi",
     "manifold",
     "limitless"
    ]
   },
   "maxItems": 16,
   "minItems": 1,
   "uniqueItems": true
  },
  "category": {
   "type": "string",
   "maxLength": 100,
   "minLength": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "state": "RECEIPTED",
  "result": {
   "output": {
    "kind": "markets",
    "state": "available",
    "events": [],
    "venues": [],
    "markets": [],
    "nextCursor": null
   }
  },
  "receipt": {
   "settlement": {
    "status": "settled"
   }
  },
  "replayed": false,
  "productId": "prediction.markets"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/clervo-prediction-markets-executor-f197364f/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.clervo.dev](https://www.zero.xyz/host/api.clervo.dev/llms.txt)