{"uid":"cap_Kq_bogoNcQo3LTyBlA3fQ","slug":"polymarket-markets-search-via-crypto-microdata-x402-b211daf0","name":"Polymarket Markets Search via Crypto Microdata (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/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_C1XtlA5iSkkTIVg94gEO0","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":"Searches Polymarket prediction market events and returns current market probabilities, liquidity, volume, and top contested markets for a given keyword.","exampleAgentPrompt":"Search Polymarket for bitcoin price prediction markets and show me the top 5 events with their current yes/no probabilities and 24h volume.","exampleUseCases":[{"title":"Bitcoin price target market lookup","prompt":"What does Polymarket currently say about Bitcoin hitting $80k or $100k? Show me the odds, liquidity, and which markets are most contested."},{"title":"Fed rate decision prediction odds","prompt":"Search Polymarket for 'fed rate' events and give me the top 6 markets per event with their current yes and no probabilities."},{"title":"Ethereum price market sentiment","prompt":"Pull up the most active Polymarket prediction markets for Ethereum, limit to 4 events, and tell me which ones are most hotly contested right now."}],"resultDescription":"Returns a list of Polymarket prediction market events matching the search keyword, each containing event title, URL, end date, total liquidity, 24h volume, and an array of individual markets with yes/no probabilities, best bid/ask prices, 24h price change, contested flag, liquidity, and volume. Also includes a top_contested summary highlighting the most active disputed market.","failureModes":["Payment failure via x402 if USDC balance on Base is insufficient","No events found for obscure or misspelled keywords returns empty events array","Rate limits or quota exhaustion on upstream Polymarket data","Stale data if Polymarket feed is delayed (check updated_at field)","Query exceeding 80 character limit returns validation error"],"whenToPreferThis":"Use this endpoint when an AI agent needs real-time Polymarket prediction market probabilities, liquidity, and volume data for a crypto or macro keyword without requiring API keys, paying only $0.003 USDC per call via x402. Prefer this over direct Polymarket API integration when operating in a pay-per-call agent architecture on Base chain.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:33:35.170Z","isFirstParty":false,"canonicalSlug":"polymarket-markets-search-via-crypto-microdata-x402-b211daf0"}