# Polymarket Market Detail Lookup

> Polymarket Market Detail Lookup is a paid API for AI agents from proxy.suverse.io, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-15).

Fetches full details for a single Polymarket prediction market by ID, including question, outcomes, prices, volume, liquidity, and resolution status via the Gamma API.

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-market-detail
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-market-detail-lookup-3394f6d7
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_23XijTKqXoE2G121q3Jfp

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 polymarket-market-detail-lookup-3394f6d7 -d '<json body>'
```

Example prompt: Can you pull up the full details for Polymarket market ID 0xabc123 — I want to see the current outcome prices, volume, liquidity, and whether it's been resolved yet?

## When to prefer this

Use this endpoint when you need comprehensive detail on a single Polymarket market — especially CLOB token IDs, conditionId, and current outcome prices — without needing to authenticate directly with Polymarket's API. Prefer this over general market listing endpoints when you already have a specific market ID and need full structured data for analysis or trading integrations.

## Known failure modes

- Invalid or non-existent market ID returns an error or empty result
- Polymarket Gamma API downtime causes fetch failure
- Malformed request body (missing required fields) returns a 400-level error
- Rate limiting or payment failure results in 402 or 429 response

## How this service works

Full detail for a single Polymarket market by id: question, outcomes, outcome prices, conditionId, CLOB token ids, volume, liquidity, resolution status. Free Polymarket Gamma data.

## Output

Returns a JSON object with the market's question text, list of outcomes, current outcome prices (probabilities), conditionId, CLOB token IDs for each outcome, cumulative trading volume, current liquidity, and resolution status indicating whether the market is open, closed, or resolved.

## 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",
    "bodyType",
    "body"
   ],
   "properties": {
    "body": {
     "properties": {}
    },
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "POST",
      "PUT",
      "PATCH"
     ],
     "type": "string"
    },
    "bodyType": {
     "enum": [
      "json",
      "form-data",
      "text"
     ],
     "type": "string"
    }
   },
   "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/polymarket-market-detail-lookup-3394f6d7/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from proxy.suverse.io](https://www.zero.xyz/host/proxy.suverse.io/llms.txt)
