{"uid":"cap_vAwZ8TtSLXaEatNKgZfSC","slug":"polymarket-bid-ask-spread-144af68a","name":"Polymarket Bid-Ask Spread","description":"Current bid-ask spread for a Polymarket outcome token from the live order book - a liquidity/uncertainty gauge. Free Polymarket CLOB data. token_id from market detail.","url":"https://proxy.suverse.io/v1/data/polymarket-bid-ask-spread","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"properties":{}},"type":{"type":"string","const":"http"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FRVQka-Z-jFtlIV2wtaaE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the current bid-ask spread for a specific Polymarket outcome token from the live CLOB order book, serving as a liquidity and uncertainty gauge.","exampleAgentPrompt":"What's the current bid-ask spread on Polymarket for the outcome token with ID 0x1234abcd? I want to see how liquid that market is right now.","exampleUseCases":[{"title":"Pre-trade liquidity check","prompt":"Before I place a bet on that Polymarket election market, can you pull the current bid-ask spread for token ID 0xabc123 so I know how much slippage to expect?"},{"title":"Uncertainty gauge for event monitoring","prompt":"I'm tracking a Polymarket market on the Fed rate decision — fetch the bid-ask spread for token 0xdef456 so I can see how uncertain traders are right now."},{"title":"Arbitrage opportunity detection","prompt":"Check the bid-ask spread on Polymarket outcome token 0x789xyz — I'm looking for wide spreads that might signal an arbitrage opportunity across prediction platforms."}],"resultDescription":"Returns the current best bid price, best ask price, and the calculated bid-ask spread (ask minus bid) for the specified Polymarket outcome token from the live Central Limit Order Book. A narrow spread indicates high liquidity and market confidence; a wide spread indicates thin liquidity or high uncertainty.","failureModes":["Invalid or unknown token_id returns an error or empty order book","Token with no active orders returns null bid or ask","Network latency may cause slightly stale order book snapshots","Malformed request body returns a 400-level error","Payment failure (x402) if USDC balance is insufficient"],"whenToPreferThis":"Choose this endpoint when you need real-time bid-ask spread data specifically from Polymarket's CLOB for a known outcome token ID. It is ideal for pre-trade analysis, liquidity screening, or uncertainty measurement on prediction market positions. Prefer this over general market data APIs when working within the Polymarket ecosystem and you already have the token_id from a market detail lookup.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:01:02.270Z","isFirstParty":false}