{"uid":"cap_eD8lkNr6dWnjq324gZkoT","slug":"polymarket-orderbook-imbalance-e7b930b2","name":"Polymarket Orderbook Imbalance","description":"108+ receipt-backed x402 work products for AI agents. Clear prices, spend caps, buyer metadata, and structured results over Base USDC.","url":"https://agenttoll.dev/paid/polymarket/orderbook-imbalance","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"limit":{"type":"integer","description":"optional integer; number of active markets to scan when token_id is omitted, default 10, max 50"},"token_id":{"type":"string","description":"optional Polymarket CLOB token ID for a single market order book"},"condition_id":{"type":"string","description":"optional Polymarket condition ID; used when available to scope a market"}}},"responseSchema":{"type":"object"},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.04","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.04/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.04","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nVNUKV-ptLskWlLCAHzhM","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.04","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Analyzes buy/sell order imbalance in Polymarket prediction market order books to surface directional pressure signals","exampleAgentPrompt":"Scan the top 20 active Polymarket markets and tell me which ones have the strongest order book imbalance right now — I want to see where there's lopsided buy or sell pressure.","exampleUseCases":[{"title":"Spot lopsided prediction market bets","prompt":"Check the order book imbalance on Polymarket for the top 15 active markets and flag any where bids or asks are heavily one-sided — I'm looking for trading opportunities."},{"title":"Monitor a specific Polymarket contract","prompt":"What's the current order book imbalance for Polymarket token ID 0x1234abcd? I want to know if buyers or sellers are dominating right now."},{"title":"Pre-trade signal check on known condition","prompt":"Before I place a position, pull the orderbook imbalance for Polymarket condition ID 0xdeadbeef and tell me whether there's more buy-side or sell-side pressure."}],"resultDescription":"Returns orderbook imbalance metrics for one or more Polymarket markets, including bid/ask volume skew, imbalance direction (buy-heavy vs sell-heavy), and associated market identifiers (token_id, condition_id). When no specific market is specified, scans a configurable number of active markets (default 10, up to 50).","failureModes":["Invalid or unknown token_id or condition_id returns an error or empty result","Polymarket CLOB API unavailable causes request failure","Requesting more than 50 markets at once is rejected","Markets with no active orders may return zero or null imbalance values","Rate limiting may occur under heavy usage"],"whenToPreferThis":"Use this endpoint when you need real-time order flow signals or directional pressure data from Polymarket prediction markets — particularly for pre-trade analysis, market surveillance, or identifying skewed liquidity. Prefer this over general market price feeds when you specifically want to understand buy vs. sell depth imbalance rather than last-traded prices. Best for agents running trading strategies, market monitoring, or research on prediction market microstructure.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T00:52:25.679Z","isFirstParty":false}