{"uid":"cap_VMg3Cy2kpBs27SiJbrjIn","slug":"aisa-mpp-data-apis-polymarket-order-books-49616adb","name":"Polymarket Order Books","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":"GET","headers":{},"bodySchema":{"type":"object","required":["token_ids"],"properties":{"token_ids":{"type":"string","description":"Comma-separated list of token IDs"}}},"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_5ubISlOEpRPk2iqtHGXIG","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 summaries (bids, asks, last trade price, tick size) for one or more Polymarket prediction market token IDs.","exampleAgentPrompt":"Can you pull the current order book for these two Polymarket tokens — 123456789 and 987654321 — and show me the top bids, asks, and last trade price for each?","exampleUseCases":[{"title":"Monitor spread before placing a trade","prompt":"What's the current bid-ask spread and last trade price for Polymarket token 71321456 right now? I want to know if there's enough liquidity before I place an order."},{"title":"Compare liquidity across multiple outcome tokens","prompt":"Can you fetch the order books for these three Polymarket outcome tokens — 111222333, 444555666, and 777888999 — and tell me which one has the tightest spread and deepest bids?"},{"title":"Track real-time price movement on a prediction market","prompt":"I'm watching a Polymarket election market. Can you keep checking the order book for token 55667788 and let me know when the last trade price crosses 0.70?"}],"resultDescription":"Returns an array of order book objects, one per token ID. Each object includes the market condition ID, asset ID, a timestamp of the snapshot, a hash of the book, sorted lists of bid and ask orders (each with price and size as strings), the minimum order size, tick size, last trade price, and a boolean indicating whether negative risk is enabled for the market.","failureModes":["Invalid or malformed token IDs return an error or empty results","Token ID not found on Polymarket returns empty order book entries","Comma-separated list formatting errors may cause parsing failures","Network or upstream Polymarket API unavailability returns a service error","Requesting too many token IDs in a single call may hit size limits"],"whenToPreferThis":"Use this endpoint when you need real-time order book depth — bids, asks, spreads, and last trade prices — for one or more Polymarket prediction market outcome tokens in a single call. It is ideal for agents that need to assess liquidity, check prices before trading decisions, or monitor market microstructure. Prefer this over a single-token endpoint when you need to compare multiple markets simultaneously without making repeated individual calls.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:57:58.497Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-order-books-49616adb"}