{"uid":"cap_Q3eI9ge-s57shpSIyLMQB","slug":"polymarket-crypto-up-down-markets-via-x402-96d57858","name":"Polymarket Crypto Up/Down Markets 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/crypto-updown?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_u3lZyC_qBfcoLEytmMdjU","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":"Fetches Polymarket prediction market events and odds for crypto price up/down questions, searchable by keyword, paid per-call with USDC on Base via x402.","exampleAgentPrompt":"Search Polymarket for Bitcoin up/down prediction markets and show me the top 5 events with their yes/no probabilities, best bid/ask, and which markets are most contested right now.","exampleUseCases":[{"title":"Pre-trade sentiment check for BTC","prompt":"Before I take a position, pull the Polymarket prediction markets for bitcoin — show me the top 8 events, especially any contested ones, and tell me what the current yes/no odds and 24h volume look like."},{"title":"Ethereum price target research","prompt":"Search Polymarket for ethereum price up/down markets, give me up to 5 events with 6 markets each, and highlight the ones with the most liquidity and the biggest 1-day probability swings."},{"title":"Macro event crypto impact markets","prompt":"Look up Polymarket markets related to 'fed rate' and crypto — I want to see the top contested questions, yes/no probabilities, and 24h trading volume for each."}],"resultDescription":"Returns a list of Polymarket prediction market events matching the search keyword, each with event title, URL, end date, total liquidity, 24h volume, and an array of individual markets showing yes/no probabilities, best bid/ask prices, 24h volume, liquidity, 1-day probability change, and whether the market is contested. Also includes a top_contested summary highlighting the most actively debated market.","failureModes":["Payment failure if USDC balance on Base is insufficient (x402 payment required)","No events found if the search keyword matches no active Polymarket markets","Stale data if Polymarket API is delayed or updated_at timestamp is old","Rate limiting or worker timeout on the Cloudflare Workers backend","Invalid query parameter types (e.g. non-integer limit) may return a 400 error"],"whenToPreferThis":"Choose this endpoint when you need real-time Polymarket prediction market odds for crypto price direction questions — especially for AI trading agents or onchain agents that need crowd-sourced probability signals without setting up API keys. It is ideal for quickly gauging market sentiment on specific crypto assets or macro events affecting crypto, and is cost-effective at $0.003 per call via x402 micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:32:50.146Z","isFirstParty":false,"canonicalSlug":"polymarket-crypto-up-down-markets-via-x402-96d57858"}