{"uid":"cap_XAm0Yq6UylJLozlZXMfL6","slug":"polymarket-live-markets-api-cff11c07","name":"Polymarket Live Markets API","description":"Query live Polymarket prediction markets — question, outcomes, live prices, bestBid/bestAsk/spread, volume24hr/volume1wk, oneDayPriceChange, clobTokenIds, conditionId, category tags, liquidity, end date. Ranked by volume24hr; filter by keyword.","url":"https://x402-data-api.sigrunner.workers.dev/pm/markets","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":{"limit":{"type":"string","description":"Max markets to return (default 20, max 100)"},"query":{"type":"string","description":"Optional keyword filter matched against the market question"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"slug":"will-x-happen-by-2026","tags":["Crypto","Bitcoin"],"active":true,"spread":0.02,"volume":1234567.89,"bestAsk":0.66,"bestBid":0.64,"endDate":"2026-12-31T12:00:00Z","outcomes":["Yes","No"],"question":"Will X happen by 2026?","liquidity":45678.12,"volume1wk":412987.6,"volume24hr":84213.45,"conditionId":"0xb6d6f15a1b5d08753653f1867ccd6126badfbe182a75159a330dc7b15336b30","clobTokenIds":["264852...","884780..."],"outcomePrices":[0.65,0.35],"oneDayPriceChange":0.01}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","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.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_a1IvJLmcQ1XE5ru2ozp2M","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns live Polymarket prediction market data including questions, outcomes, prices, spreads, volume, and liquidity ranked by 24-hour volume with optional keyword filtering","exampleAgentPrompt":"Show me the top 20 most active Polymarket prediction markets right now — filter them to just crypto-related markets and include the current bid/ask prices, spread, and 24-hour volume for each.","exampleUseCases":null,"resultDescription":"A list of Polymarket prediction markets ranked by 24-hour volume, each including the market question, possible outcomes, live prices, best bid/best ask/spread, 24hr and 1-week volume, 1-day price change, CLOB token IDs, condition ID, category tags, liquidity, and end date.","failureModes":["Invalid or unsupported query parameter returns empty results","Exceeding limit of 100 markets returns only up to 100","Polymarket API downtime causes 502/503 errors","Payment of 0.005 USDC not provided results in 402 Payment Required","Keyword filter with no matches returns empty market list"],"whenToPreferThis":"Use this endpoint when you need live Polymarket prediction market data including prices, spreads, and volume metrics. Prefer it over manually scraping Polymarket when you need structured, ranked market data with filtering. Best for agents building prediction market dashboards, monitoring market sentiment, or finding specific markets by keyword.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:36:51.244Z","isFirstParty":false}