# HivemindOS Prediction Market Search

> HivemindOS Prediction Market Search is a paid API for AI agents from api.hivemindos.app, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-28).

Search prediction markets by topic or sort by activity, returning odds, volume, liquidity, and end dates for each market.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/predictionMarkets.search?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hivemindos-prediction-market-search-b27a31de
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_hSYRZoVFiA4At9v4p1Ajc

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 hivemindos-prediction-market-search-b27a31de -d '<json body>'
```

Example prompt: Search HivemindOS for active prediction markets about the Fed rate cut, sorted by 24-hour volume, and show me the odds, liquidity, and end dates for each.

## When to prefer this

Use this endpoint when an agent needs real-time prediction market odds, volume, or liquidity data for a specific topic or event, or wants to surface the most active markets across all topics. Prefer this over general financial data APIs when the user specifically wants crowd-sourced probabilistic forecasts rather than price feeds or news sentiment.

## Known failure modes

- Query too short (minLength 2) returns validation error
- No matching markets found for niche topic returns empty list
- Invalid sortBy value returns schema validation error
- Payment failure or insufficient USDC balance prevents the call from executing
- Rate limits or downtime on upstream prediction market data sources may return stale or partial results

## How this service works

Prediction market search: prediction markets by topic, or the busiest ones, with each market's odds, volume, liquidity and end date. Use when an agent needs current prediction-market odds on a topic or event. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

A list of prediction markets matching the query or sort criteria, each including market title, current odds, 24-hour and total volume, liquidity, open interest, unique trader count, and market end date. If includeEvents is true, markets are also grouped by their parent event.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "tags": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 40
   },
   "maxItems": 5,
   "description": "Optional topic tags to filter by."
  },
  "query": {
   "type": "string",
   "maxLength": 120,
   "minLength": 2,
   "description": "A topic or event, such as fed rate cut."
  },
  "sortBy": {
   "enum": [
    "volume_24hr",
    "volume",
    "volume_1wk",
    "volume_1mo",
    "liquidity",
    "open_interest",
    "unique_traders_24h",
    "age_hours"
   ],
   "type": "string"
  },
  "status": {
   "enum": [
    "active",
    "closed"
   ],
   "type": "string"
  },
  "request": {
   "type": "string",
   "maxLength": 2000,
   "description": "The read in plain words, naming the address, $SYMBOL, chain or exchange."
  },
  "includeEvents": {
   "type": "boolean",
   "description": "Also group markets by event."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-prediction-market-search-b27a31de/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.hivemindos.app](https://www.zero.xyz/host/api.hivemindos.app/llms.txt)