{"uid":"cap_5givlcFZyOZlWgEw1LNhu","slug":"polymarket-market-order-book-054cbd6e","name":"Polymarket Market & Order Book","description":"One Polymarket market by slug, id or URL: question, rules, outcome probabilities, best bid/ask, last trade, 1-day change, volume, liquidity and the order book (top bids and asks with sizes and spread) for each outcome. An event slug returns all its markets. Use before placing a trade or to quote exact odds.","url":"https://bess-x402.onrender.com/v1/predictions/polymarket/market?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["market"],"properties":{"depth":{"type":"integer","description":"Order book levels per side (1-20)"},"market":{"type":"string","description":"Market slug, numeric id or polymarket.com URL"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","displayCostAsset":"USDC","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GozLn0cdJVEGUDhpQe6ut","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches a Polymarket prediction market's question, outcome probabilities, best bid/ask, order book depth, volume, liquidity, and 1-day change by slug, ID, or URL.","exampleAgentPrompt":"Pull up the current Polymarket market for 'will-the-fed-cut-rates-in-2025' — I want to see the outcome probabilities, best bid and ask, and the top 5 levels of the order book on each side before I place a trade.","exampleUseCases":[{"title":"Pre-trade odds check","prompt":"Before I buy YES on the Polymarket 'us-recession-2025' market, can you show me the current outcome probabilities, best bid and ask prices, the spread, and volume so I know what I'm getting into?"},{"title":"Event market overview","prompt":"I want to see all the markets under the Polymarket event slug 'us-elections-2026' — give me the current probabilities, liquidity, and 24-hour price changes for each outcome."},{"title":"Order book depth for limit order","prompt":"Show me the top 10 levels of the order book for both YES and NO on the Polymarket market at polymarket.com/event/bitcoin-above-100k-by-year-end — I need the sizes and spread to set my limit order."}],"resultDescription":"Returns the market question, trading rules, outcome probabilities, best bid and ask per outcome, last trade price, 1-day price change, volume, liquidity, and a configurable number of top order book levels (bids and asks with sizes and spread) for each outcome. For event slugs, returns all associated markets.","failureModes":["Invalid or misspelled market slug returns an error or empty result","Market ID not found on Polymarket returns a 404-style error","Order book depth outside the 1-20 range may be rejected or clamped","Stale or recently resolved markets may return no active order book data","Network or upstream Polymarket API outage causes timeout or 5xx error"],"whenToPreferThis":"Use this endpoint when you need real-time Polymarket prediction market data — odds, order book, spread, volume, and liquidity — before placing a trade or to quote exact probabilities. It is purpose-built for Polymarket and returns richer order book depth than generic prediction market aggregators. Prefer it over scraping Polymarket directly or using generic crypto price feeds when you need structured outcome probability and order book data in a single call.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T06:43:42.551Z","isFirstParty":false,"canonicalSlug":"polymarket-market-order-book-054cbd6e"}