{"uid":"cap_NsNPQudYPWdSbU8sDa_L-","slug":"agent-data-tools-revmesh2074-workers-dev-polymarket-order-book-08a75e11","name":"Polymarket Order Book","description":"Polymarket order book for one market outcome from the CLOB: bids and asks (price and size) up to 50 levels, best bid and ask, mid, spread and USD depth within 5 cents of the mid on each side. Give the market slug and outcome, or a CLOB token id. Use to check liquidity and slippage before a trade, or to read a sharper price than the last trade.","url":"https://agent-data-tools.revmesh2074.workers.dev/polymarket/orderbook?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"slug":{"type":"string","description":"The market's Polymarket slug (from polymarket_markets) or its polymarket.com URL"},"depth":{"type":"integer","description":"Levels per side, 1-50 (default 10)"},"outcome":{"type":"string","description":"Outcome name, e.g. Yes or No (default the first outcome)"},"token_id":{"type":"string","description":"Instead of slug: the CLOB token id of one outcome"}}},"responseSchema":{"type":"object","properties":{"mid":{"type":"number"},"asks":{"type":"array","items":{"type":"object","properties":{"size":{"type":"number"},"price":{"type":"number"}}}},"bids":{"type":"array","items":{"type":"object","properties":{"size":{"type":"number"},"price":{"type":"number"}}}},"note":{"type":"string"},"slug":{"type":"string"},"spread":{"type":"number"},"bestAsk":{"type":"number"},"bestBid":{"type":"number"},"outcome":{"type":"string"},"tokenId":{"type":"string"},"bookTime":{"type":"string"},"question":{"type":"string"},"askDepthUsd":{"type":"number"},"bidDepthUsd":{"type":"number"},"conditionId":{"type":"string"}}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.01","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Of5v9kC7oLKMH3sck3hOw","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agent-data-tools.revmesh2074.workers.dev","brandSlug":"agent-data-tools-revmesh2074-workers-dev-x402","brandBaseUrl":"https://agent-data-tools.revmesh2074.workers.dev","brandDocsUrl":null,"whatItDoes":"Returns the live CLOB order book (bids, asks, mid, spread, USD depth) for a specific Polymarket prediction market outcome","exampleAgentPrompt":"Pull up the Polymarket order book for the Yes outcome on the 'will-the-fed-cut-rates-in-2025' market — show me 20 levels on each side so I can see the spread and USD liquidity before I trade.","exampleUseCases":[{"title":"Pre-trade slippage check","prompt":"Before I buy $1,000 worth of Yes shares on the Polymarket 'will-btc-hit-100k-in-2025' market, can you check the order book and tell me how much slippage I should expect?"},{"title":"Sharp price discovery","prompt":"What's the current mid price and spread on the No outcome of the Polymarket Trump election market? I want a sharper price than the last trade shows."},{"title":"Liquidity depth monitoring","prompt":"Check the Polymarket order book for the Yes side of the 'us-recession-2025' market and tell me how much USD is sitting within 5 cents of the mid on each side."}],"resultDescription":"Returns a JSON object with: arrays of bid and ask levels each containing price and size, best bid and ask prices, mid price, spread, USD depth within 5 cents of mid on bid and ask sides, the market slug, outcome name, CLOB token ID, condition ID, market question text, and a timestamp of when the book was read. Optionally includes a note field for warnings or context.","failureModes":["Invalid or unknown market slug returns an error — use polymarket_markets to find valid slugs","Unknown outcome name returns an error — verify exact outcome string (e.g. 'Yes' vs 'yes')","Invalid token_id returns an error or empty book","Depth out of range (not 1–50) returns a validation error","Market with no open orders returns empty bids or asks arrays","CLOB API downtime may cause timeouts or stale data"],"whenToPreferThis":"Use this endpoint when you need live order book data for a Polymarket prediction market — specifically to assess liquidity, calculate expected slippage before trading, or get a more accurate current price than the last-trade price. Prefer it over last-trade price endpoints when market microstructure matters (thin books, wide spreads). Use the token_id parameter when you already have the CLOB token from another Polymarket endpoint, or use slug+outcome for a more human-readable query.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-06T06:36:07.234Z","isFirstParty":false,"canonicalSlug":"agent-data-tools-revmesh2074-workers-dev-polymarket-order-book-08a75e11"}