# Polymarket Market Detail Lookup

> Polymarket Market Detail Lookup is a paid API for AI agents from agent402.tools, paid per call via x402, $0.002/call, status unknown (last checked 2026-09-14).

Fetches full details for a single Polymarket prediction market by slug or numeric ID, including prices, volume, liquidity, resolution status, and CLOB token IDs.

## Facts

- Endpoint: POST https://agent402.tools/api/polymarket-market
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-market-detail-lookup-fb35142b
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_79EmEgTTMrpBazL1AijBN

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-fb35142b -d '<json body>'
```

Example prompt: Pull up the full details for the Polymarket market with slug 'will-trump-win-2024-presidential-election' — I want to see the current outcome prices, volume, liquidity, end date, and the CLOB token IDs.

## When to prefer this

Use this endpoint when you need comprehensive details about a specific Polymarket market and already know the market slug or numeric ID. Prefer this over generic web scraping when you need structured data including CLOB token IDs for further orderbook or trade history lookups.

## Known failure modes

- Neither slug nor id provided — returns validation error
- Invalid or non-existent slug/id — returns not found error
- Polymarket API upstream outage — returns 502 or timeout
- Market exists but has been delisted — may return empty or error response

## How this service works

Get full detail for a single Polymarket market by slug or id. Returns question, description, outcome prices (implied probabilities), volume, liquidity, end date, resolution status, and CLOB token ids needed for orderbook + history lookups.

## Output

Returns the market question text, description, outcome prices as implied probabilities (e.g. YES: 0.72, NO: 0.28), total trading volume, liquidity, market end date, resolution status, and CLOB token IDs required for orderbook and price history queries.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "id": {
   "type": "string",
   "description": "Numeric market id (one of slug/id required)."
  },
  "slug": {
   "type": "string",
   "description": "Market slug (one of slug/id required)."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "12345",
  "slug": "will-x-win-election",
  "venue": "polymarket",
  "active": true,
  "closed": false,
  "prices": [
   0.62,
   0.38
  ],
  "volume": 1234567.89,
  "endDate": "2026-11-03T23:59:00Z",
  "archived": false,
  "outcomes": [
   "Yes",
   "No"
  ],
  "question": "Will X win the election?",
  "venueUrl": "https://polymarket.com/market/will-x-win-election",
  "eventSlug": "us-election-2026",
  "liquidity": 56789.01,
  "description": "Resolves YES if X is declared the winner by AP.",
  "clobTokenIds": [
   "7290...",
   "8390..."
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-market-detail-lookup-fb35142b/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agent402.tools](https://www.zero.xyz/host/agent402.tools/llms.txt)
