# Quotient Prediction Market Semantic Search

> Quotient Prediction Market Semantic Search is a paid API for AI agents from quotient-api-gateway.onrender.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-13).

Search prediction markets by semantic meaning across Polymarket, Kalshi, and Limitless, returning ranked markets with live odds, tags, categories, and relevance scores

## Facts

- Endpoint: GET https://quotient-api-gateway.onrender.com/api/v1/markets/search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/quotient-prediction-market-semantic-search-e39fe5a5
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_MlWeKkPAOZUUAvVe4Ekbj

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 quotient-prediction-market-semantic-search-e39fe5a5
```

Example prompt: Find me prediction markets related to Federal Reserve rate cuts — search across Polymarket and Kalshi and group results by event so I can see which markets are most relevant right now.

## When to prefer this

Use this endpoint when you know the topic or theme you want to trade but don't know the exact market name or slug. It excels at semantic discovery across multiple venues simultaneously, making it superior to keyword search when the topic is broad (e.g. 'rate cuts') or when you want to compare related markets grouped by event. Prefer this over direct market browsing endpoints when the user's intent is exploratory research rather than fetching a specific known market.

## Known failure modes

- No markets found for highly niche or misspelled queries — returns empty results
- Invalid venue enum value returns a validation error
- Query string too vague may return loosely related markets with low relevance scores
- Rate limit or payment failure returns 402 or 429 error
- Service on Render free tier may have cold-start latency on first request

## How this service works

Use this to search Quotient-covered markets by meaning, taxonomy, asset, venue, or historical cutoff. Results carry quote provenance plus Q and venue odds captured at the selected forecast. Polymarket International and Kalshi use verified live pricing or null; other venues label graph snapshots stale. Use as_of for discovery and the forecast-time pair for historical spreads, including since-closed markets.

## Output

A ranked list of prediction markets matching the semantic query, each including the market name, parent event, venue (Polymarket/Kalshi/Limitless), live odds, tags, categories, and a relevance score. Results can optionally be grouped by parent event for easier comparison of related markets.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input",
  "output"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method",
    "queryParams"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string"
      },
      "tag": {
       "type": "array",
       "items": {
        "type": "string",
        "maxLength": 80
       }
      },
      "as_of": {
       "type": "string"
      },
      "venue": {
       "enum": [
        "polymarket",
        "polymarket_us",
        "kalshi",
        "limitless"
       ],
       "type": "string",
       "description": "Prediction-market venue key: polymarket (Polymarket International), polymarket_us (Polymarket US), kalshi, or limitless."
      },
      "category": {
       "type": "array",
       "items": {
        "type": "string",
        "maxLength": 80
       }
      },
      "group_by": {
       "enum": [
        "market",
        "event"
       ],
       "type": "string",
       "default": "market"
      },
      "max_forecast_age": {
       "type": "integer",
       "default": 168,
       "minimum": 1
      }
     },
     "additionalProperties": false
    }
   },
   "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/quotient-prediction-market-semantic-search-e39fe5a5/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from quotient-api-gateway.onrender.com](https://www.zero.xyz/host/quotient-api-gateway.onrender.com/llms.txt)
