# Polymarket Orderbook Imbalance

> Polymarket Orderbook Imbalance is a paid API for AI agents from agenttoll.dev, paid per call via x402, $0.04/call, status unknown (last checked 2026-09-15).

Analyzes buy/sell order imbalance in Polymarket prediction market order books to surface directional pressure signals

## Facts

- Endpoint: POST https://agenttoll.dev/paid/polymarket/orderbook-imbalance
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/polymarket-orderbook-imbalance-e7b930b2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_eD8lkNr6dWnjq324gZkoT

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-orderbook-imbalance-e7b930b2 -d '<json body>'
```

Example prompt: Scan the top 20 active Polymarket markets and tell me which ones have the strongest order book imbalance right now — I want to see where there's lopsided buy or sell pressure.

## When to prefer this

Use this endpoint when you need real-time order flow signals or directional pressure data from Polymarket prediction markets — particularly for pre-trade analysis, market surveillance, or identifying skewed liquidity. Prefer this over general market price feeds when you specifically want to understand buy vs. sell depth imbalance rather than last-traded prices. Best for agents running trading strategies, market monitoring, or research on prediction market microstructure.

## Known failure modes

- Invalid or unknown token_id or condition_id returns an error or empty result
- Polymarket CLOB API unavailable causes request failure
- Requesting more than 50 markets at once is rejected
- Markets with no active orders may return zero or null imbalance values
- Rate limiting may occur under heavy usage

## How this service works

108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.

## Output

Returns orderbook imbalance metrics for one or more Polymarket markets, including bid/ask volume skew, imbalance direction (buy-heavy vs sell-heavy), and associated market identifiers (token_id, condition_id). When no specific market is specified, scans a configurable number of active markets (default 10, up to 50).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "description": "optional integer; number of active markets to scan when token_id is omitted, default 10, max 50"
  },
  "token_id": {
   "type": "string",
   "description": "optional Polymarket CLOB token ID for a single market order book"
  },
  "condition_id": {
   "type": "string",
   "description": "optional Polymarket condition ID; used when available to scope a market"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/polymarket-orderbook-imbalance-e7b930b2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agenttoll.dev](https://www.zero.xyz/host/agenttoll.dev/llms.txt)