{"uid":"cap_nBnugcNo56GVBzjC74H9q","slug":"aisa-mpp-data-apis-polymarket-order-books-batch-1d19c945","name":"Polymarket Order Books (Batch)","description":"Retrieves order book summaries for multiple token IDs using a request body.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.012 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/polymarket/books?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"array","items":{"type":"object","required":["token_id"],"properties":{"side":{"enum":["BUY","SELL"],"type":"string","example":"BUY","description":"Order side (optional, not used for midpoint calculation)"},"token_id":{"type":"string","example":"0xabc123def456...","description":"Token ID (asset ID)"}}}},"responseSchema":{"type":"array","items":{"type":"object","required":["market","asset_id","timestamp","hash","bids","asks","min_order_size","tick_size","neg_risk","last_trade_price"],"properties":{"asks":{"type":"array","items":{"type":"object","required":["price","size"],"properties":{"size":{"type":"string","example":"100","description":"Order size"},"price":{"type":"string","example":"0.45","description":"Order price"}}},"description":"List of ask orders (sorted by price ascending)"},"bids":{"type":"array","items":{"type":"object","required":["price","size"],"properties":{"size":{"type":"string","example":"100","description":"Order size"},"price":{"type":"string","example":"0.45","description":"Order price"}}},"description":"List of bid orders (sorted by price descending)"},"hash":{"type":"string","example":"a1b2c3d4e5f6...","description":"Hash of the order book summary"},"market":{"type":"string","example":"0x1234567890123456789012345678901234567890","description":"Market condition ID"},"asset_id":{"type":"string","example":"0xabc123def456...","description":"Token ID (asset ID)"},"neg_risk":{"type":"boolean","example":false,"description":"Whether negative risk is enabled for this market"},"tick_size":{"type":"string","example":"0.01","description":"Minimum price increment (tick size)"},"timestamp":{"type":"string","example":"1234567890","description":"Timestamp of the order book snapshot"},"min_order_size":{"type":"string","example":"1","description":"Minimum order size"},"last_trade_price":{"type":"string","example":"0.45","description":"Last trade price"}}}},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_plbRp0Vmeq6Xmf0QT52tF","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Retrieves order book snapshots (bids, asks, last trade price, tick size) for one or more Polymarket token IDs in a single request.","exampleAgentPrompt":"Can you pull the current order book for these two Polymarket tokens — 0xabc123def456 and 0xdef789abc012 — and tell me the best bid, best ask, and last trade price for each?","exampleUseCases":[{"title":"Checking spread before placing a trade","prompt":"Before I place an order, can you grab the order book for Polymarket token 0xabc123def456 and tell me the current best bid and ask prices and how wide the spread is?"},{"title":"Monitoring liquidity across multiple markets","prompt":"I'm tracking three Polymarket prediction markets with token IDs 0xtoken1, 0xtoken2, and 0xtoken3 — can you pull the full order book for all three and tell me how deep the bid and ask sides are?"},{"title":"Getting last trade price for arbitrage check","prompt":"What was the last trade price and current order book snapshot for Polymarket token 0xabc999xyz on the BUY side? I want to compare it against another exchange."}],"resultDescription":"An array of order book objects, one per requested token ID. Each object contains the market condition ID, asset ID, a timestamp, a hash of the snapshot, sorted lists of bid orders (price descending) and ask orders (price ascending) each with price and size, the minimum order size, the tick size, a neg_risk boolean, and the last trade price.","failureModes":["Invalid or non-existent token_id returns an empty or error response","Malformed request body (missing required token_id field) returns a validation error","Rate limiting or upstream Polymarket API downtime causes request failure","Stale data if Polymarket's order book feed is delayed","Empty bids or asks arrays for illiquid or inactive markets"],"whenToPreferThis":"Use this endpoint when you need to fetch order book data for one or more Polymarket prediction market tokens in a single call, especially when batch retrieval is needed. Prefer this over single-token endpoints when querying multiple markets simultaneously to reduce round trips. Ideal for agents monitoring liquidity, computing spreads, or checking execution conditions before placing trades on Polymarket.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:50.290Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-order-books-batch-1d19c945"}