# Joe Market Data – Polymarket Search

> Joe Market Data – Polymarket Search is a paid API for AI agents from joe-market-data.marnick-yezo.workers.dev, paid per call via x402, $0.001/call, status unknown (last checked 2026-09-14).

Searches Polymarket prediction markets by free-text query, returning matching markets and their current odds

## Facts

- Endpoint: GET https://joe-market-data.marnick-yezo.workers.dev/pm-search
- Price: $0.001/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/joe-market-data-polymarket-search-3752d7a9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_9zhbBZZU_JDx--_woBfzp

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 joe-market-data-polymarket-search-3752d7a9
```

Example prompt: Search Polymarket for prediction markets about a Fed rate cut and show me the current odds and how many markets match.

## When to prefer this

Use this endpoint when you need to find Polymarket prediction market odds on any current event, macro trend, or crypto outcome. It is the right choice when users ask about crowd-sourced probability estimates or prediction market consensus on financial, political, or crypto topics. Prefer this over general web search when you want structured market data with odds rather than news articles.

## Known failure modes

- No markets found for query — returns count 0 and empty markets array
- Missing required 'query' query parameter — likely returns 400 or error status
- Payment failure via x402 protocol if USDC payment on Base is not processed
- Polymarket upstream API unavailable — may return error status
- Query too vague returns irrelevant or zero results

## How this service works

Public-data market intel for AI agents: token prices (CoinGecko), DefiLlama TVL/fees/stables, Polymarket odds. Otto-compatible path names. $0.001 USDC per call on Base. No LLM/TTS/image.

## Output

Returns a JSON object with a list of matching Polymarket prediction markets (including titles and odds), the total count of matched markets, the original query string, and metadata including source, endpoint path, and the $0.001 USDC cost per call.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "pathParams": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "required": [
      "query"
     ],
     "properties": {
      "query": {
       "type": "string",
       "description": "Free-text search (e.g. fed rate cut, bitcoin 150k)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "count": 0,
   "query": "bitcoin",
   "markets": []
  },
  "meta": {
   "source": "polymarket",
   "endpoint": "/pm-search",
   "cost_usdc": "0.001"
  },
  "status": "success"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/joe-market-data-polymarket-search-3752d7a9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from joe-market-data.marnick-yezo.workers.dev](https://www.zero.xyz/host/joe-market-data.marnick-yezo.workers.dev/llms.txt)