# HivemindOS Prediction Market Detail

> HivemindOS Prediction Market Detail 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).

Returns a single prediction market's odds history, order book, and recent trades, optionally including its largest holder positions.

## Facts

- Endpoint: POST https://api.hivemindos.app/v1/x402/onchain-intelligence/predictionMarkets.market?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-detail-53fca361
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_mvbx26TvDl3rE4Y9PxqxA

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-detail-53fca361 -d '<json body>'
```

Example prompt: Pull up the full detail on prediction market ID 'pm-election-2024-us-president' — I want the odds history and order book for the past week, and also show me who holds the biggest positions.

## When to prefer this

Use this endpoint when you already have a specific prediction market ID and need its full historical and current market microstructure — odds over time, the live order book, and recent trade flow. Prefer this over a market search endpoint when the market is already identified and you need depth of data rather than discovery. It is the right choice when building trading analysis, due diligence on a position, or monitoring a specific market's activity.

## Known failure modes

- Invalid or unknown marketId returns an error or empty result
- Date range with no data returns empty history arrays
- Missing required marketId may cause a 400 validation error
- Payment failure in x402 flow results in no data returned
- Extremely wide date ranges may time out or return partial data

## How this service works

Prediction market detail: one prediction market's odds history, order book and recent trades, with its largest positions on request. Use when an agent needs one prediction market's odds history, order book and recent trades. $0.05 this call, in USDC on Base; you pay only if it succeeds. HivemindOS SuperAgent API.

## Output

Returns structured data for a single prediction market including: historical odds over the requested date window, a current order book snapshot (bids and asks), a list of recent trades with timestamps and prices, and optionally the largest wallet positions in that market if includeHolders is true.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "date": {
   "type": "object",
   "required": [
    "from",
    "to"
   ],
   "properties": {
    "to": {
     "type": "string",
     "format": "date"
    },
    "from": {
     "type": "string",
     "format": "date"
    }
   },
   "description": "The window to read, as YYYY-MM-DD dates. Defaults to recent days."
  },
  "request": {
   "type": "string",
   "maxLength": 2000,
   "description": "The read in plain words, naming the address, $SYMBOL, chain or exchange."
  },
  "marketId": {
   "type": "string",
   "maxLength": 100,
   "description": "The market id from a prediction market search."
  },
  "includeHolders": {
   "type": "boolean",
   "description": "Also return its largest positions."
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hivemindos-prediction-market-detail-53fca361/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)