{"uid":"cap_As9jvGIxM0TwTr_SP_LB-","slug":"oddify-events-list-polymarket-events-with-filtering-search-and-1bd7ab36","name":"Oddify Events List - Polymarket Events with Filtering, Search, and Pagination","description":"Get events with filtering, search, and pagination","url":"https://api.oddify.xyz/api/v1/data/events","method":"POST","headers":{},"bodySchema":null,"responseSchema":{"output":{"data":{"meta":"object","events":"array","pagination":"object"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","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.0001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_ECxwjchoVXbUgDLwB2yhx","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0001","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a paginated, filterable, and searchable list of prediction market events from Polymarket via the Oddify data gateway","exampleAgentPrompt":"Show me the first 20 active Polymarket events related to US politics, sorted by most recent.","exampleUseCases":null,"resultDescription":"Returns a structured response containing an array of Polymarket events matching the query, along with pagination details (total count, current page, page size) and response metadata. Each event includes information about the underlying prediction market event.","failureModes":["Invalid filter parameters return an error response","Pagination out of bounds returns empty events array","Search query yields no results returning empty array","Payment failure (insufficient USDC) blocks request","Rate limiting or quota exceeded returns error","Malformed POST body causes validation error"],"whenToPreferThis":"Use this endpoint when you need to browse, search, or filter multiple Polymarket events at once with pagination support. Prefer this over the single-event endpoint when you need a list or don't have a specific event ID. Choose this over the markets endpoint when you want event-level granularity rather than individual market contracts.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:40:18.445Z","isFirstParty":false}