`polymarket_event_books`

Pack: polymarket · Endpoint: https://gateway.pipeworx.io/polymarket/mcp

Live order books for every tradable market in a single Polymarket event, in one request.

Tool description as the model sees it

Batched CLOB orderbooks for EVERY tradable market in one Polymarket event — single round trip via the CLOB batch /books endpoint. Use before any multi-leg strategy (partition arbitrage “SELL/BUY EVERY LEG”, basket trades) to check per-leg depth: theoretical overround means nothing if half the legs are 50-share books. Returns legs[] with {slug, question, yes_price, best_bid, best_ask, yes_bids[], yes_asks[]} where bids are sorted best(highest)-first and asks best(lowest)-first as {price, size} objects. Pass include_no=true to also fetch NO-side books (doubles payload — only needed for NO-leg strategies). Caps at 80 legs (highest yes_price kept; truncated_legs reports the cut).

Parameters

Name	Type	Required	Description
`event_slug_or_id`	string	yes	Event slug (e.g. “fed-decision-may-2026”) or numeric id — same input as polymarket_event.
`include_no`	boolean	no	Also fetch NO-side books for each leg (default false).

Example call

Arguments

{
  "event_slug_or_id": "republican-presidential-nominee-2028"
}

curl

curl -X POST https://gateway.pipeworx.io/polymarket/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"polymarket_event_books","arguments":{"event_slug_or_id":"republican-presidential-nominee-2028"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('polymarket_event_books', {
  "event_slug_or_id": "republican-presidential-nominee-2028"
});

More examples

{
  "event_slug_or_id": "fed-decision-in-january-20260729233815502",
  "include_no": true
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "polymarket": {
      "url": "https://gateway.pipeworx.io/polymarket/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

polymarket_event_books