# agentsvc.io Prediction Markets Search

> agentsvc.io Prediction Markets Search is a paid API for AI agents from agentsvc.io, paid per call via x402, $0.009/call, status unknown (last checked 2026-10-10).

Search Polymarket prediction markets by topic or retrieve top markets by 24-hour volume, returning probabilities, liquidity, and price data.

## Facts

- Endpoint: POST https://agentsvc.io/api/v1/proxy/prediction-markets?utm_source=zero.xyz
- Price: $0.009/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agentsvc-io-prediction-markets-search-0f4c2ba6
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_87CHh-hamt3rtGKCjqNnV

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 agentsvc-io-prediction-markets-search-0f4c2ba6 -d '<json body>'
```

Example prompt: What are the top 5 Polymarket prediction markets related to bitcoin right now — show me the probabilities, liquidity, and 24h volume for each?

## When to prefer this

Choose this endpoint when you need real-time crowd-sourced probability estimates for future events, especially crypto, politics, or sports. It aggregates Polymarket's liquidity and volume signals, making it ideal for assessing market consensus without needing a Polymarket account or API key. Prefer this over general web search when you need structured probability data with liquidity context rather than news articles.

## Known failure modes

- Query returns zero markets if the topic is too niche or misspelled
- Limit parameter outside 1–25 range returns a validation error
- Stale data if Polymarket API is slow or unavailable at fetch time
- Network timeout or upstream Polymarket outage causing failed response
- Payment failure via x402 if insufficient USDC balance on Base

## How this service works

86 APIs for AI agents: web scraping and crawling to Markdown, AI summaries, data extraction and cited answers, screenshots and PDF, PDF, OCR and document conversion, news, paper and developer search and more, paid per call with USDC on Base, Solana, Polygon or Arbitrum via x402. No account, no API key, free sample on every service.

## Output

A JSON object containing: the search query used, the data source (Polymarket), a count of results, a timestamp of when data was fetched, and an array of market objects each with the event name, question text, outcome probabilities (Yes/No percentages), liquidity in USD, 24h volume in USD, total volume in USD, 24h price change, and a URL to the Polymarket event page.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "default": 10,
   "maximum": 25,
   "minimum": 1
  },
  "query": {
   "type": "string",
   "description": "Topic to search, e.g. 'bitcoin' or 'election'. Omit for top markets by 24h volume."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 1,
   "query": "bitcoin",
   "source": "Polymarket",
   "markets": [
    {
     "url": "https://polymarket.com/event/bitcoin-above-on-october-6-2026",
     "event": "Bitcoin above ___ on October 6?",
     "end_date": "2026-10-06T16:00:00Z",
     "outcomes": [
      {
       "name": "Yes",
       "probability": 0.9975
      },
      {
       "name": "No",
       "probability": 0.0025
      }
     ],
     "question": "Will the price of Bitcoin be above $82,000 on October 6?",
     "liquidity_usd": 46546.4,
     "volume_24h_usd": 86277.68,
     "price_change_24h": 0.011,
     "volume_total_usd": 129904.32
    }
   ],
   "fetched_at": "2026-10-06T12:00:00.000Z"
  },
  "success": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agentsvc-io-prediction-markets-search-0f4c2ba6/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agentsvc.io](https://www.zero.xyz/host/agentsvc.io/llms.txt)