{"uid":"cap_7QCBwlyY_aw7j6F7MrUSG","slug":"polymarket-prediction-market-search-api-7069d4a2","name":"Polymarket Prediction Market Search API","description":"Crypto market data and web tools for autonomous agents: read web pages, PDFs and YouTube transcripts, check domains and tokens. Every `/api/v1/*` call is paid per call: **$0.003** for simple reads, **$0.005-$0.01** for aggregates, **$0.02-$0.03** for token risk checks and reports (USDC or USDT). Each route's price is in `x-payment-info`.\n\n**x402 agents:** pay automatically. The 402 response carries a standard `PAYMENT-REQUIRED` header (x402 v2, USDC on Base or Solana, USDT on Solana); retry with `PAYMENT-SIGNATURE`.\n\n**Manual (legacy) flow:** call the endpoint, read the HTTP 402 JSON (`pay_to`, `asset`, `price`), send the USDT transfer, then repeat the call with header `X-Payment-Tx: <signature>`. One signature pays for one call; signatures older than the `max_tx_age_seconds` value are rejected.\n\nMachine-readable spec: `/openapi.json`. LLM summary: `/llms.txt`. MCP server: `POST /mcp`.","url":"https://194-28-85-99.sslip.io/api/v1/polymarket?utm_source=zero.xyz","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","properties":{"q":{"type":"string","description":"Search words"},"limit":{"type":"integer","maximum":50,"minimum":1}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"bitcoin","markets":[{"outcomes":[{"name":"Yes","probability":0.23},{"name":"No","probability":0.77}],"question":"Will Bitcoin reach $150k in 2026?","volume_24h_usd":1250000}]}},"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":"down","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_6Q99HGJ9dourQlFQjoBxq","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":"Search Polymarket prediction markets by keyword, returning questions, outcome probabilities, and 24-hour trading volume","exampleAgentPrompt":"Search Polymarket for prediction markets about Bitcoin hitting $150k in 2026 and show me the current Yes/No probabilities and 24-hour trading volume — give me up to 5 results.","exampleUseCases":[{"title":"Crypto price event probability check","prompt":"What does Polymarket currently give as the probability that Bitcoin reaches $150k in 2026? Search for up to 5 related markets and show me the Yes and No odds."},{"title":"Election outcome market research","prompt":"Search Polymarket for prediction markets about the 2024 US presidential election and show me the top 10 results with their current outcome probabilities and trading volumes."},{"title":"Fed rate cut market sentiment","prompt":"Look up Polymarket markets about a Federal Reserve interest rate cut this year — I want to see the current probabilities and how much volume is being traded on them."}],"resultDescription":"A JSON array of matching Polymarket prediction markets, each containing the market question, a list of outcomes with names and probabilities (0–1 scale), and the 24-hour trading volume in USD.","failureModes":["No markets found for query — empty markets array returned","Payment not provided or signature expired — HTTP 402 with pay_to, asset, and price fields","Query exceeds maximum limit of 50 — validation error","Polymarket data source unavailable — upstream timeout or error response","Invalid or reused payment signature — rejected with max_tx_age_seconds message"],"whenToPreferThis":"Use this endpoint when you need real-time crowd-sourced probability estimates from Polymarket's prediction market platform, especially for crypto, finance, politics, or macroeconomic events. Prefer this over general web search when you want structured probability and volume data rather than news articles or opinion. Best for agents needing quantitative forecasts expressed as market odds.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-17T07:28:18.338Z","isFirstParty":false,"canonicalSlug":"polymarket-prediction-market-search-api-7069d4a2"}