{"uid":"cap_VTL74jYq_TJtkOjLhJ5Hp","slug":"polymarket-structured-data-scraper-336cc968","name":"Polymarket Structured Data Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/polymarket?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"sortBy":{"enum":["volume24hr","liquidity","endDate","startDate","volumeNum"],"type":"string","default":"volume24hr","description":"Sort by 24 hour volume, liquidity, end date, start date, or lifetime volume."},"status":{"enum":["active","closed","all"],"type":"string","default":"active","description":"Choose active, closed, or all records."},"tagIds":{"type":"array","default":[],"description":"Numeric Polymarket tag IDs. Combine with category slugs to include more topics."},"itemType":{"enum":["markets","events"],"type":"string","default":"markets","description":"Return one row per market or one row per event group."},"categories":{"type":"array","default":[],"description":"Polymarket tag slugs such as politics, crypto, sports, technology, entertainment, elections, or basketball. Multiple categories are combined."},"minLiquidity":{"type":"integer","default":0,"minimum":0,"description":"Keep records with at least this USD liquidity. Event liquidity is the sum of its markets."},"minVolume24h":{"type":"integer","default":0,"minimum":0,"description":"Keep records with at least this USD volume over the previous 24 hours."},"maxItemsTotal":{"type":"integer","default":200,"minimum":0,"description":"Hard cap on dataset rows and run cost."},"searchQueries":{"type":"array","default":[],"description":"Find matching public events by keyword. Each phrase is searched separately; results are merged."},"minTotalVolume":{"type":"integer","default":0,"minimum":0,"description":"Keep records with at least this USD lifetime traded volume."},"minutesUntilEnd":{"type":"integer","default":0,"minimum":0,"description":"Exclude records ending sooner than this many minutes. Zero disables the filter."},"maxItemsPerSource":{"type":"integer","default":500,"minimum":0,"description":"Maximum records scanned per category or search phrase. Increase when filters are selective; each API page contains at most 100 records."},"minPriceChangePct":{"type":"integer","default":0,"minimum":0,"description":"For market rows, require at least this absolute one week or one month price move in percentage points. Ignored for events."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"eventId":null,"marketId":null,"question":null,"eventSlug":null,"eventTitle":null,"marketSlug":null,"recordType":null,"description":null}],"product":"polymarket"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.24","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.24/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.24","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6ZbBshYvpvgyZdEK96ZXE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.24","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Fetches filtered, sorted structured data from Polymarket prediction markets and events, including prices, volumes, liquidity, and market metadata.","exampleAgentPrompt":"Pull the top 50 active Polymarket prediction markets in the politics and crypto categories, sorted by 24-hour volume, with at least $5000 in liquidity — give me the market question, slug, and current volume for each.","exampleUseCases":[{"title":"Track hot election prediction markets","prompt":"Get me the top 20 active Polymarket markets tagged with elections, sorted by 24-hour volume, and only include ones with at least $10,000 liquidity — I want to see which races people are betting on most right now."},{"title":"Monitor crypto markets about to close","prompt":"Find all active Polymarket crypto markets that expire within the next 1440 minutes, sorted by end date, with at least $1000 in lifetime volume — I need to see which ones are closing soon."},{"title":"Research AI topic prediction markets","prompt":"Search Polymarket for any events or markets related to 'artificial intelligence' and 'OpenAI', return up to 100 results sorted by liquidity, and include both active and closed markets so I can see historical ones too."}],"resultDescription":"A JSON object with a count field and an items array, each item containing marketId, eventId, question, eventSlug, eventTitle, marketSlug, recordType, description, and associated financial metrics like volume and liquidity for the matched Polymarket markets or events.","failureModes":["Empty result set if filters are too restrictive (not charged)","Truncated results if maxItemsTotal is hit before all matching records are scanned","Stale data if Polymarket API is delayed or rate-limited upstream","Category slug or tag ID not recognized, returning zero results","Search query returns no matching public events"],"whenToPreferThis":"Use this endpoint when you need structured, filterable Polymarket data without building your own scraper or maintaining a Polymarket API integration. It is ideal for agents that need to query prediction market data by topic, liquidity threshold, or volume, especially with pay-per-successful-call pricing that avoids charges on empty runs.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:58.639Z","isFirstParty":false,"canonicalSlug":"polymarket-structured-data-scraper-336cc968"}