# Polymarket Token Best Price (CLOB)

> Polymarket Token Best Price (CLOB) 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-14).

Returns the best bid or best ask price for a Polymarket outcome token from the live Central Limit Order Book (CLOB).

## Facts

- Endpoint: POST https://proxy.suverse.io/v1/data/polymarket-token-price
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-token-best-price-clob-f547e950
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_6LB4BV_4VxqkRCIMwNhx9

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-token-best-price-clob-f547e950 -d '<json body>'
```

Example prompt: What's the current best ask price to buy shares in the 'Yes' outcome token on Polymarket — the token_id is 71321045679252212594626385532706912750332728571942532289631379312455583992563 and I want the buy side.

## When to prefer this

Use this endpoint when you need real-time best bid or ask price data for a specific Polymarket outcome token without setting up your own CLOB connection. It is ideal for price checks before trading, portfolio valuation, spread analysis, or monitoring prediction market sentiment. Prefer this over building a direct Polymarket CLOB integration when you want a simple pay-per-call REST interface with no API key setup required.

## Known failure modes

- Invalid or unknown token_id returns an error or empty result
- Invalid side value (not 'buy' or 'sell') causes a validation error
- Polymarket CLOB API unavailable causes a timeout or upstream error
- No liquidity on the requested side may return null or zero price
- Malformed request body causes a 400 bad request error

## How this service works

Best bid or best ask price for a Polymarket outcome token from the live CLOB. Free Polymarket CLOB data. token_id from market detail; side = buy or sell.

## Output

Returns the best bid or best ask price (depending on the requested side) for the specified Polymarket outcome token as a numeric price value from the live CLOB, reflecting the top of the order book at query time.

## 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-token-best-price-clob-f547e950/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)