{"service":"Attena Prediction Market Search","version":"v3","usage":"GET /api/search/?q=bitcoin","params":{"q":"Search query (supports natural language, e.g. 'nba on kalshi trending')","limit":"Max results (default 50, max 200)","offset":"Pagination offset","source":"kalshi | polymarket","category":"sports | crypto | politics | economics | weather | entertainment | science | culture | motorsport | geopolitics","league":"NBA | NFL | NHL | MLB | F1 | NCAA | MLS","subcategory":"Subcategory filter (e.g. bitcoin, nba)","event_date":"Filter by date (YYYY-MM-DD)","min_volume":"Minimum volume threshold (e.g. 100000)","sort":"relevance | volume | trending | closing_soon | newest","mode":"lite (tsvector-only, fast) | default (Vertex AI + LLM)","agent":"true → skip LLM normalizer, saves ~500ms (recommended for AI agents)","format":"text → markdown table (fewer tokens for LLMs) | default → JSON"},"examples":["/api/search/?q=bitcoin&sort=volume","/api/search/?q=nba&source=kalshi&sort=trending","/api/search/?q=election&agent=true&format=text","/api/search/?source=polymarket&sort=volume&limit=20","/api/search/?q=nfl closing soon&agent=true"],"tips":{"agent_mode":"Use agent=true to skip the LLM normalizer. You're already an LLM — no need for double processing. Saves ~500ms.","text_format":"Use format=text for a compact markdown table. Much fewer tokens than JSON.","inline_filters":"Natural language works: 'nba on kalshi trending above 1m' extracts source, sort, and min_volume automatically."},"docs":"https://attena.xyz/docs/api"}