Fetches resting order book depth for a Polymarket outcome
pm_orderbookFetches resting order book depth for a Polymarket outcome token (or market slug and outcome name). Returns top 20 bids and asks, midpoint price, spread, depth within 1/2/5 cents, and last trade price. Information only, not financial advice. Related tools on this server, for a different need: pm_history when you need to fetch historical price points for a Polymarket outcome; pm_event when you need to fetch details for a single Polymarket event by slug. Price: $0.003 per successful call, paid with x402 (USDC on Base, Solana and 10 more networks); failed calls are not charged.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"tokenId": "<tokenId>"
},
"name": "pm_orderbook"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Market slug if tokenId is unknown | |
| outcome | No | Outcome name (e.g. Yes or No) when slug is provided | |
| tokenId | Yes | Outcome CLOB token ID (numeric string) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mid | No | ||
| asks | No | ||
| bids | No | ||
| depth | No | ||
| market | No | ||
| source | No | ||
| spread | No | ||
| bestAsk | No | ||
| bestBid | No | ||
| tokenId | No | ||
| asksCount | No | ||
| bidsCount | No | ||
| checkedAt | No | ||
| disclaimer | No | ||
| lastTradePrice | No |