Skip to content
onelayer.
All tools

Tool detail

prediction-markets

Searches and filters prediction-market events across Kalshi, Polymarket and Gemini by keyword, exchange, category, status and volume/open-interest thresholds.

Categories: Prediction markets, Market prices

Use when

  • search prediction markets by keyword or ticker
  • filter prediction markets by exchange, status or category
  • find prediction markets within a volume or open-interest range
  • sort prediction-market events by 24h volume or close time

Not for

  • not price history for a market — a separate endpoint
  • not semantic similar-market search

Inputs

GET query params, all optional: search, event_ticker, entity_code, status, outcome_type, pmcs_category/supersector, sort_by/sort_dir, limit, offset, volume/open_interest/trade_count min/max

Admitted input schema

{
  "type": "object",
  "properties": {
    "entity_code": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Exchange filter. Common: KALSHI, POLYMARK, GMNI."
    },
    "event_ticker": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Exact event identifier (from a prior /prediction-markets response)."
    },
    "limit": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Maximum number of events to return."
    },
    "offset": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Zero-based pagination offset."
    },
    "open_interest_max": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Maximum open interest (USD)."
    },
    "open_interest_min": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum open interest (USD)."
    },
    "outcome_type": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Outcome model. Common: Binary, Multi."
    },
    "pmcs_category": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Top-level PMCS category code from /prediction-markets/taxonomy."
    },
    "pmcs_supersector": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "PMCS supersector code from /prediction-markets/taxonomy."
    },
    "queryCriteria": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Legacy advanced query field; prefer search."
    },
    "search": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Free-text query across market and event names."
    },
    "searchString": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Legacy alias for search; prefer search."
    },
    "sort_by": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Sort key, e.g. total_volume_24hr, total_open_interest_usd, end_ts."
    },
    "sort_dir": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Sort direction: asc or desc."
    },
    "status": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Market status. Open is the safest default."
    },
    "trade_count_max": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Maximum trade count."
    },
    "trade_count_min": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum trade count."
    },
    "volume_1hr_max": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Maximum 1-hour volume filter."
    },
    "volume_1hr_min": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum 1-hour volume filter."
    },
    "volume_max": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Maximum total volume filter."
    },
    "volume_min": {
      "type": "string",
      "minLength": 0,
      "maxLength": 4096,
      "description": "Minimum total volume filter."
    }
  },
  "required": [],
  "additionalProperties": false
}

Endpoint

Method
GET
URL
https://api.predictionmarketdata.io/prediction-markets

Payment

Protocol
x402
Listed price
0.001 USDC per call on Base
Payment method
exact
Network
eip155:8453
Asset
0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913

Listed terms are catalog metadata. The caller supplies inputs and calls the tool outside Onelayer. If payment is required, the caller uses a compatible wallet to pay.

Source

Record
GET https://api.predictionmarketdata.io/prediction-markets
Retrieved
2026-09-30T20:37:07.382Z
Catalog file SHA-256
6837ccddf886f0007cf3727ea9d27faaa5047b51b4f425345c554ce1c271a524
Catalog built
2026-09-30T22:31:58.034Z