{"uid":"cap_5GNTYxvF2ShpCUb7Qc2pN","slug":"polymarket-search-crypto-prediction-market-data-bcab8a4b","name":"Polymarket Search – Crypto Prediction Market Data","description":"Pay-per-call crypto microdata for trading/onchain AI agents via x402 (USDC on Base): Base gas, token risk, balances, multi-venue prices, Hyperliquid book/funding, kimchi premium. No API keys.","url":"https://kr-x402-mvp.kgy5612.workers.dev/api/v1/pm/markets/search?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","examples":["bitcoin","ethereum","fed rate","election"],"maxLength":80,"description":"Search keyword (default crypto)"},"limit":{"type":"integer","maximum":20,"minimum":1,"description":"Events to return (default 8)"},"markets":{"type":"integer","maximum":20,"minimum":1,"description":"Markets per event (default 6)"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"q":"bitcoin","events":[{"url":"https://polymarket.com/event/bitcoin-above-on-october-30","title":"Bitcoin above ___ on October 30?","markets":[{"no_prob":0.38,"best_ask":0.63,"best_bid":0.61,"question":"Will the price of Bitcoin be above $80,000 on October 30?","yes_prob":0.62,"change_1d":0.05,"contested":true,"liquidity":50000,"volume_24h":41000,"outcome_label":"80,000"}],"end_date":"2026-10-30T16:00:00Z","liquidity":610000,"volume_24h":281751.88}],"source":"polymarket","n_events":1,"updated_at":"2026-10-29T15:30:00Z","top_contested":{"event":"Bitcoin above ___ on October 30?","question":"Will the price of Bitcoin be above $80,000 on October 30?","yes_prob":0.62,"volume_24h":41000}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_hp0sMzXaJntR_43u13YQz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","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 and retrieve event odds, liquidity, volume, and contestedness for crypto and macro topics","exampleAgentPrompt":"Search Polymarket for Bitcoin price prediction events, show me up to 10 events with 6 markets each, including odds, liquidity, and which ones are most contested right now.","exampleUseCases":[{"title":"Bitcoin price target odds check","prompt":"Search Polymarket for Bitcoin prediction markets and show me the yes/no probabilities, 24h volume, and which events are most contested — return up to 8 events."},{"title":"Macro event market search","prompt":"Look up Polymarket prediction markets about the fed rate decision and give me the odds, liquidity, and best bid/ask for the top 6 markets per event."},{"title":"Altcoin sentiment via prediction markets","prompt":"Search Polymarket for Ethereum prediction market events, show me 5 events with up to 4 markets each, and flag any that are highly contested."}],"resultDescription":"Returns a list of Polymarket events matching the search keyword, each with event title, URL, end date, total liquidity, and 24h volume. Each event includes individual market questions with yes/no probabilities, best bid/ask prices, 24h price change, liquidity, volume, and a contested flag. Also returns the top contested market overall and metadata like source and update timestamp.","failureModes":["No events found for obscure or misspelled keywords — returns empty events array","Payment failure if USDC balance is insufficient for x402 micropayment","Rate limiting or worker timeout on the Cloudflare edge if query is too broad","Stale data if Polymarket hasn't updated recently — check updated_at field","Invalid query parameter types (e.g. non-integer limit) may return 400 error"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time Polymarket prediction market probabilities for crypto or macro topics without managing API keys. Ideal for trading agents that want to gauge market sentiment via prediction market odds, check contestedness, or compare liquidity across events. Prefer over direct Polymarket API access when you need pay-per-call pricing via USDC micropayments with no subscription overhead.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:34.366Z","isFirstParty":false,"canonicalSlug":"polymarket-search-crypto-prediction-market-data-bcab8a4b"}