{"uid":"cap_rPgB2ZuBXjWk_Uup9L2xx","slug":"polymarket-prediction-market-signal-6e35f9f9","name":"Polymarket Prediction Market Signal","description":"Enclave402: x402 pay-per-call gateway on Base. Live Polymarket signals, IPFS pinning, EIP-712 attestations. Receipt-gated settlement, replay protection, no charge on failure.","url":"https://enclave402.com/api/market/signal","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"slug":{"type":"string","pattern":"^[a-z0-9-]{3,200}$","examples":["will-there-be-no-change-in-fed-interest-rates-after-the-october-2026-meeting-20260617190324031"],"maxLength":200,"description":"Optional Polymarket market slug for one specific market. Omit to receive the top markets by 24h volume."},"limit":{"type":"integer","default":5,"maximum":10,"minimum":1,"description":"Number of top markets to return when slug is omitted."}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["source","query","markets","asOf","settled","ts"],"properties":{"ts":{"type":"integer","description":"Response timestamp, UNIX milliseconds"},"asOf":{"type":"string","description":"ISO-8601 timestamp the data was fetched"},"query":{"type":"object","description":"Echo of the resolved query (slug, or top/orderBy)"},"source":{"enum":["polymarket-gamma","polymarket-gamma+clob+trades"],"type":"string","description":"Upstream data providers"},"markets":{"type":"array","items":{"type":"object","required":["id","slug","question","outcomes","outcomePrices","impliedProbability","momentum"],"properties":{"id":{"type":"string","description":"Polymarket market id"},"slug":{"type":"string","description":"URL slug of the market"},"spread":{"type":["number","null"],"description":"bestAsk - bestBid"},"bestAsk":{"type":["number","null"],"description":"Best ask for the first outcome"},"bestBid":{"type":["number","null"],"description":"Best bid for the first outcome"},"derived":{"type":"object","required":["priceDelta1h","priceDelta6h","realizedVol24h","whaleFlow","errors"],"properties":{"errors":{"type":"array","items":{"type":"string"},"description":"Provider-scoped reasons a derived field is null (e.g. clob:timeout)"},"whaleFlow":{"type":["object","null"],"required":["windowSec","trades","netYesUsdc","largestTradeUsdc","whaleTrades","flow"],"properties":{"flow":{"enum":["YES_ACCUMULATION","YES_DISTRIBUTION","BALANCED","NO_TRADES"],"type":"string"},"trades":{"type":"integer"},"windowSec":{"type":"integer"},"buyYesUsdc":{"type":"number"},"netYesUsdc":{"type":"number"},"sellYesUsdc":{"type":"number"},"whaleTrades":{"type":"integer"},"largestTradeUsdc":{"type":"number"},"whaleThresholdUsdc":{"type":"number"}},"description":"Trade-tape summary over the last 6h; BUY of NO counts as SELL of YES","additionalProperties":false},"priceDelta1h":{"type":["number","null"],"description":"YES price now minus YES price 1h ago"},"priceDelta6h":{"type":["number","null"],"description":"YES price now minus YES price 6h ago"},"historySamples":{"type":"integer","description":"Price points used"},"realizedVol24h":{"type":["number","null"],"description":"Std-dev of 10-minute log returns over the last 24h"}},"description":"Fields not in the free listing: computed from the CLOB price history and the public trade tape. Null with a reason in errors when a provider is unavailable.","additionalProperties":false},"endDate":{"type":["string","null"],"description":"ISO-8601 market end date"},"momentum":{"enum":["RISING","FALLING","FLAT","UNKNOWN"],"type":"string","description":"Deterministic label: RISING if 24h change >= +0.02, FALLING if <= -0.02, else FLAT"},"outcomes":{"type":"array","items":{"type":"string"},"description":"Outcome labels, index-aligned with outcomePrices"},"question":{"type":"string","description":"Market question text"},"liquidity":{"type":["number","null"],"description":"Order-book liquidity in USD"},"volume24hr":{"type":["number","null"],"description":"24h notional volume in USD"},"conditionId":{"type":["string","null"],"description":"On-chain condition id (bytes32 hex)"},"outcomePrices":{"type":"array","items":{"type":"number"},"description":"Current outcome prices in [0,1] (implied probabilities)"},"oneDayPriceChange":{"type":["number","null"],"description":"24h change of the first outcome price (absolute, in probability points)"},"impliedProbability":{"type":["number","null"],"description":"Price of the first outcome (YES) in [0,1]"}},"additionalProperties":false},"description":"Normalized market rows"},"settled":{"type":"boolean","description":"true when an x402 payment settled for this response (false on free-quota or dry-run)"}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"ts":1767225600000,"asOf":"2026-01-01T00:00:00.000Z","query":{"top":1,"orderBy":"volume24hr"},"source":"polymarket-gamma","markets":[{"id":"0","slug":"sample-market","spread":0.02,"bestAsk":0.51,"bestBid":0.49,"endDate":null,"momentum":"FLAT","outcomes":["Yes","No"],"question":"Sample question?","liquidity":0,"volume24hr":0,"conditionId":null,"outcomePrices":[0.5,0.5],"oneDayPriceChange":0,"impliedProbability":0.5}],"settled":true}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_-XVJlff_XJTB5LrVvsbYq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches live Polymarket crowd-implied probabilities, bid/ask spreads, 24h volume, liquidity, and momentum labels for one specific market or the top markets by volume.","exampleAgentPrompt":"What is the current Polymarket crowd probability for the Fed leaving interest rates unchanged at their October 2026 meeting? Pull the signal for 'will-there-be-no-change-in-fed-interest-rates-after-the-october-2026-meeting-20260617190324031' and include the bid/ask spread and 24h momentum.","exampleUseCases":[{"title":"Real-time election outcome probability","prompt":"What does Polymarket currently think are the odds of the Republican candidate winning the 2026 Senate race in Arizona? Pull the signal for that market and tell me the implied probability, the spread, and whether pricing has been moving up or down in the last 24 hours."},{"title":"Top prediction markets dashboard","prompt":"Show me the top 3 most-traded Polymarket markets right now — I want the crowd probability, 24h volume, and momentum label for each so I can see where attention is focused."},{"title":"Macro event probability for trading decision","prompt":"What is Polymarket's current implied probability for a US recession being declared before the end of 2025? Get the live signal including best bid, best ask, and 24h price change so I can factor it into my positioning."}],"resultDescription":"Returns a JSON payload with one or more market objects, each containing the market question, outcome prices (implied probabilities), best bid, best ask, spread, 24h price change, a deterministic momentum label (e.g. FLAT, UP, DOWN), 24h volume, liquidity depth, and response timestamps. When no slug is provided, returns the top markets ranked by 24h volume up to the requested limit.","failureModes":["Invalid or non-existent slug returns an error or empty markets array","Limit out of range (below 1 or above 10) causes a validation error","Upstream Polymarket Gamma/CLOB APIs unavailable causes a fetch failure; no charge is applied on failure","Market has ended or been resolved — data may be stale or absent","Rate limiting or x402 payment settlement failure may prevent response"],"whenToPreferThis":"Choose this endpoint when an agent needs the real-time crowd-implied probability of a specific real-world event (political, macroeconomic, sports, etc.) from Polymarket, or wants a ranked list of the most actively traded prediction markets. It is the right choice for event probability lookup, momentum analysis, and liquidity assessment. Do NOT use it for spot cryptocurrency prices, DEX swap quotes, or order execution — it is strictly read-only prediction market data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-18T06:30:20.606Z","isFirstParty":false}