Polymarket Event Groups & Live Markets by Keyword

Use this endpoint when you need a broad discovery pass across all Polymarket event groups and markets for a given topic in one call — ideal for forecasting agents, trading bots, or research tools that need to survey the prediction market landscape before drilling into specific order books or trade history. Prefer this over the keyword search endpoint when you want full event group hierarchy with nested markets and odds, not just top-level market titles.

• No matching events found for the keyword — returns empty results or 404
• Keyword too vague — returns unrelated or overly broad event groups
• Payment not received — returns 402 Payment Required if USDC payment not included
• Polymarket data unavailable — upstream outage may return 503 or stale data
• Invalid path parameter — malformed keyword may cause 400 Bad Request