{"uid":"cap_XcGL4tqhG5v2Qh8Oi442p","slug":"polymarket-markets-search-via-x402-9c3d5a9c","name":"Polymarket Markets Search via x402","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/polymarket/markets?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_JlfzGgNYWyOzMqyRoVhfF","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, returning event probabilities, liquidity, volume, and top contested markets","exampleAgentPrompt":"Search Polymarket for bitcoin prediction markets and show me the top 5 events with up to 6 markets each — I want to see current yes/no probabilities, liquidity, and which ones are most contested right now.","exampleUseCases":[{"title":"Check crypto price prediction odds","prompt":"What does Polymarket currently think about Bitcoin's chances of hitting $80k? Show me the top 8 events with up to 6 markets each, including yes/no probabilities and 24h volume."},{"title":"Track contested Fed rate markets","prompt":"Search Polymarket for 'fed rate' prediction markets — give me the 5 most active events, and flag which markets are most hotly contested right now."},{"title":"Monitor election prediction markets","prompt":"Pull up Polymarket prediction markets for 'election' — show me 10 events with 8 markets each, including liquidity and the top contested question."}],"resultDescription":"Returns a list of Polymarket prediction market events matching the search keyword, each with associated markets showing yes/no probabilities, best bid/ask, 24h volume, liquidity, 1-day price change, and contested flag. Also includes a top_contested summary highlighting the most actively debated market across all returned events.","failureModes":["No matching events found for obscure or misspelled keywords","Stale data if Polymarket feed is delayed","Payment failure via x402 if USDC balance on Base is insufficient","Query exceeding 80 character maxLength rejected","limit or markets parameter out of allowed range (1-20) causes validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time Polymarket prediction market data — probabilities, liquidity, and contested status — for a given topic, without requiring API keys. Ideal for trading agents, crypto news monitors, or market sentiment analyzers that want crowd-sourced probability signals and prefer pay-per-call USDC micropayments over subscription APIs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:32:46.336Z","isFirstParty":false,"canonicalSlug":"polymarket-markets-search-via-x402-9c3d5a9c"}