{"uid":"cap_6LB4BV_4VxqkRCIMwNhx9","slug":"polymarket-token-best-price-clob-f547e950","name":"Polymarket Token Best Price (CLOB)","description":"Best bid or best ask price for a Polymarket outcome token from the live CLOB. Free Polymarket CLOB data. token_id from market detail; side = buy or sell.","url":"https://proxy.suverse.io/v1/data/polymarket-token-price","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_jOgkZ9KcfdiFJMwiSkUye","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 best bid or best ask price for a Polymarket outcome token from the live Central Limit Order Book (CLOB).","exampleAgentPrompt":"What's the current best ask price to buy shares in the 'Yes' outcome token on Polymarket — the token_id is 71321045679252212594626385532706912750332728571942532289631379312455583992563 and I want the buy side.","exampleUseCases":[{"title":"Pre-trade price check for Polymarket bet","prompt":"Before I place a buy order on Polymarket, can you look up the best ask price for token_id 71321045679252212594626385532706912750332728571942532289631379312455583992563 on the buy side so I know what price to expect?"},{"title":"Monitor prediction market outcome price","prompt":"What's the latest bid price I could sell my 'Yes' outcome tokens for on Polymarket? The token_id is 52114319501245915516055106046884209969926127482827954674443846427813813222426 and I'm on the sell side."},{"title":"Compare bid and ask for arbitrage analysis","prompt":"Can you fetch both the best bid and best ask prices for Polymarket token 71321045679252212594626385532706912750332728571942532289631379312455583992563 so I can see the current spread before deciding whether to trade?"}],"resultDescription":"Returns the best bid or best ask price (depending on the requested side) for the specified Polymarket outcome token as a numeric price value from the live CLOB, reflecting the top of the order book at query time.","failureModes":["Invalid or unknown token_id returns an error or empty result","Invalid side value (not 'buy' or 'sell') causes a validation error","Polymarket CLOB API unavailable causes a timeout or upstream error","No liquidity on the requested side may return null or zero price","Malformed request body causes a 400 bad request error"],"whenToPreferThis":"Use this endpoint when you need real-time best bid or ask price data for a specific Polymarket outcome token without setting up your own CLOB connection. It is ideal for price checks before trading, portfolio valuation, spread analysis, or monitoring prediction market sentiment. Prefer this over building a direct Polymarket CLOB integration when you want a simple pay-per-call REST interface with no API key setup required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:03:03.642Z","isFirstParty":false}