{"uid":"cap_9nLRVYd6nP8uamb2MeOlH","slug":"2s-predict-price-clob-outcome-token-price-lookup-bebf03af","name":"2s Predict Price — CLOB Outcome Token Price Lookup","description":"Live best bid, best ask, and midpoint for a Polymarket outcome token (CLOB token id — get it from predict.markets clobTokenIds). The midpoint is the market's implied probability for that outcome. Read-only from Polymarket's CLOB.","url":"https://2s.io/api/predict/price","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"type":"object","required":["tokenId"],"properties":{"tokenId":{"type":"string","maxLength":120,"minLength":1,"description":"CLOB token id (outcome token)."}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["ok","items","total","source"],"properties":{"ok":{"enum":[true],"type":"boolean"},"items":{"type":"array","items":{"type":"object","required":["tokenId","bid","ask","mid"],"properties":{"ask":{"type":"number","nullable":true},"bid":{"type":"number","nullable":true},"mid":{"type":"number","nullable":true},"tokenId":{"type":"string"}},"additionalProperties":false}},"total":{"type":"integer","nullable":true,"description":"Total matching rows upstream; null when unknown."},"source":{"type":"object","required":["provider","url","license"],"properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}},"additionalProperties":false}},"additionalProperties":false},"example":{"ok":true,"items":[{"ask":1,"bid":1,"mid":1,"tokenId":"example"}],"total":1,"source":{"url":"example","license":"example","provider":"example"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0z1p3SvC_IATPt0QaVYsL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches the current predicted price for a CLOB (Central Limit Order Book) outcome token by its token ID, useful for prediction market probability lookups.","exampleAgentPrompt":"What's the current predicted price for CLOB outcome token '0xabc123def456' on the prediction market — I want to know the market-implied probability right now.","exampleUseCases":null,"resultDescription":"Returns the current predicted price for the specified CLOB outcome token, representing its market-implied probability or fair value as determined by the order book.","failureModes":["Missing or invalid tokenId returns an error or empty result","Token ID not found in the CLOB system returns a 404 or null price","Payment failure (USDC/x402) results in 402 Payment Required before data is returned","Network timeout or upstream data unavailability returns a 5xx error"],"whenToPreferThis":"Use this endpoint when you need the real-time market-implied price or probability for a specific CLOB prediction market outcome token and have the token ID available. Prefer this over general price APIs when dealing specifically with prediction market outcome tokens rather than standard crypto or equity assets.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:03:18.675Z","isFirstParty":false}