{"uid":"cap_5pRcnoQURnCPfahu353iW","slug":"polymarket-clob-orderbook-e6dcf67a","name":"Polymarket CLOB Orderbook","description":"Live CLOB orderbook for a Polymarket outcome token. Returns top N bids (highest first), top N asks (lowest first), best bid/ask, mid-price, and spread. Use a clobTokenId from polymarket-market or polymarket-search.","url":"https://agent402.tools/api/polymarket-orderbook","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"depth":{"type":"number","description":"Levels each side to return (1-50, default 10)."},"tokenId":{"type":"string","description":"CLOB token id (decimal string) from market.clobTokenIds."}}},"responseSchema":{"type":"json","example":{"asks":[{"size":800,"price":0.63},{"size":1200,"price":0.64}],"bids":[{"size":1000,"price":0.61},{"size":500,"price":0.6}],"asset":"72909...","market":"0xabc...","source":"polymarket-clob","spread":0.02,"bestAsk":0.63,"bestBid":0.61,"tokenId":"72909...","midPrice":0.62,"timestamp":"1751234567"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_xLYuwLdKB9-v2UFgDf3q3","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live CLOB orderbook data for a Polymarket outcome token, including top N bids and asks, best bid/ask, mid-price, and spread.","exampleAgentPrompt":"Pull the live Polymarket orderbook for token ID 12345678 with 20 levels on each side — show me the top bids and asks, best bid/ask, mid-price, and spread.","exampleUseCases":null,"resultDescription":"Returns a structured orderbook with top N bids (sorted highest first) and top N asks (sorted lowest first) for the specified Polymarket CLOB outcome token, along with the best bid price, best ask price, mid-price, and spread.","failureModes":["Invalid or unknown clobTokenId returns an error or empty orderbook","Depth value outside 1-50 range may be rejected or clamped","Polymarket CLOB API unavailable causes upstream timeout","Payment failure (x402) results in 402 status and no data returned","Stale or illiquid market may return sparse or empty orderbook levels"],"whenToPreferThis":"Use this endpoint when you need real-time orderbook depth, liquidity, and pricing information for a specific Polymarket outcome token. Prefer this over general market info endpoints when you need precise bid/ask levels for trading decisions, arbitrage analysis, or market making on Polymarket's CLOB.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:51:48.659Z","isFirstParty":false}