{"uid":"cap_jhoUTVIfzI1Ra59n1uHy6","slug":"aisa-mpp-data-apis-polymarket-spreads-batch-2a219c5c","name":"Polymarket Spreads (Batch)","description":"Retrieves spreads for multiple token IDs. The spread is the difference between the best ask and best bid prices.\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/spreads?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":"object","description":"Map of token ID to spread","additionalProperties":{"type":"string"}},"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_ljG90nKaYGZ0S4stZp9K8","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 bid-ask spreads for multiple Polymarket prediction market token IDs in a single request.","exampleAgentPrompt":"Can you pull the current bid-ask spreads for these Polymarket token IDs: 0xabc123def456 and 0xdef789ghi012? I want to see how liquid these markets are.","exampleUseCases":[{"title":"Liquidity screening before trading","prompt":"Before I place orders on these five Polymarket tokens, can you check their spreads so I know which markets are the most liquid right now? The token IDs are 0xabc1, 0xdef2, 0xghi3, 0xjkl4, 0xmno5."},{"title":"Arbitrage opportunity detection","prompt":"I want to compare the bid-ask spreads across these prediction market tokens to spot any unusually wide spreads that might signal an arbitrage opportunity — can you pull the spread data for token IDs 0xabc123, 0xdef456, and 0xghi789?"},{"title":"Portfolio spread monitoring dashboard","prompt":"For my Polymarket portfolio, can you fetch the current spreads for all ten of my token IDs so I can track how market tightness is changing over time?"}],"resultDescription":"A JSON object mapping each token ID (string key) to its corresponding spread value (string), representing the difference between the best ask and best bid prices for that prediction market token.","failureModes":["Invalid or non-existent token IDs return missing keys or empty results","Malformed input array (missing required token_id field) causes a 400 validation error","Network or server errors may return 5xx responses","Empty input array returns an empty object","Stale or illiquid markets may return zero or very large spreads"],"whenToPreferThis":"Use this endpoint when you need spread data for multiple Polymarket token IDs in one call rather than making individual price requests. It is ideal for batch liquidity analysis, portfolio monitoring, or pre-trade checks across many markets simultaneously. Prefer this over the single-token price endpoint when you have two or more tokens to evaluate.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:42:58.269Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-polymarket-spreads-batch-2a219c5c"}