# Rekko AI

> Prediction market intelligence API — deep AI research, causal analysis, and trading signals for Kalshi, Polymarket, and Coinbase.

Rekko AI is the intelligence layer for prediction market trading bots, apps, and agents. It runs multi-stage AI research pipelines that produce probability estimates, Bayesian causal decomposition of price drivers, portfolio-aware trading signals, cross-platform arbitrage detection, and execution guidance. Covers Kalshi (CFTC-regulated), Polymarket (crypto), Robinhood (mainstream retail), and Coinbase (Kalshi-powered). Clean flat JSON designed for developers and autonomous trading agents.

Base URL: `https://api.rekko.ai/v1`
Auth: Bearer token (`Authorization: Bearer rk_free_...` or `rk_pro_...`)
OpenAPI spec: `https://api.rekko.ai/openapi.json`

## Docs

- [Quickstart](https://rekko.ai/docs/quickstart): Get an API key and make your first call in 5 minutes
- [Authentication](https://rekko.ai/docs/authentication): Bearer tokens, key prefixes, key rotation, error responses
- [Pricing](https://rekko.ai/docs/pricing): Endpoint tiers (LISTING $0.01, INSIGHT $0.10, STRATEGY $2.00, DEEP $5.00), subscription plans (Free/Pro/Enterprise)
- [API Reference](https://rekko.ai/docs/api-reference/introduction): Full endpoint reference with interactive playground

## Core Concepts

- [Markets](https://rekko.ai/docs/concepts/markets): Market identifiers, object schema, price interpretation, lifecycle, platform differences
- [Analysis Pipeline](https://rekko.ai/docs/concepts/analysis-pipeline): Async 3-step pattern (trigger, poll, retrieve), analysis object, caching and freshness
- [Signals](https://rekko.ai/docs/concepts/signals): Signal schema, recommendation types, edge calculation, Kelly-derived sizing, risk ratings
- [Causal Decomposition](https://rekko.ai/docs/concepts/causal-decomposition): Weighted Bayesian factors with evidence, prior/posterior updates, aggregation methods
- [Expand Parameter](https://rekko.ai/docs/concepts/expand-parameter): Expandable fields — causal, scenarios, meta, history, analysis, scoring

## API Endpoints

- [List Events](https://rekko.ai/docs/api-reference/events/list-events): `GET /v1/events` — List prediction market events with aggregate stats (LISTING tier)
- [Trending Events](https://rekko.ai/docs/api-reference/events/trending-events): `GET /v1/events/trending` — Top events by trending score (LISTING tier)
- [Search Events](https://rekko.ai/docs/api-reference/events/search-events): `GET /v1/events/search` — Hybrid full-text + semantic event search (LISTING tier)
- [Get Event](https://rekko.ai/docs/api-reference/events/get-event): `GET /v1/events/{slug}` — Single event detail with optional market expansion (LISTING tier)
- [Event Markets](https://rekko.ai/docs/api-reference/events/event-markets): `GET /v1/events/{slug}/markets` — List individual outcome markets within an event (LISTING tier)
- [List Markets](https://rekko.ai/docs/api-reference/markets/list-markets): `GET /v1/markets` — Browse active prediction markets with pricing (LISTING tier)
- [Get Market](https://rekko.ai/docs/api-reference/markets/get-market): `GET /v1/markets/{platform}/{market_id}` — Single market detail (LISTING tier)
- [Market History](https://rekko.ai/docs/api-reference/markets/market-history): `GET /v1/markets/{platform}/{market_id}/history` — Price and volume history (LISTING tier)
- [Trigger Analysis](https://rekko.ai/docs/api-reference/insights/trigger-analysis): `POST /v1/markets/{platform}/{market_id}/analyze` — Start async AI analysis (INSIGHT tier)
- [Poll Status](https://rekko.ai/docs/api-reference/insights/poll-status): `GET /v1/markets/{platform}/{market_id}/analyze/{analysis_id}/status` — Check analysis progress (INSIGHT tier)
- [Get Analysis](https://rekko.ai/docs/api-reference/insights/get-analysis): `GET /v1/markets/{platform}/{market_id}/analysis` — Retrieve completed analysis (INSIGHT tier)
- [List Analyses](https://rekko.ai/docs/api-reference/insights/list-analyses): `GET /v1/analyses` — Recent analysis summaries (INSIGHT tier)
- [Screen Markets](https://rekko.ai/docs/api-reference/insights/screen-markets): `POST /v1/screen` — Batch screen markets with lightweight scoring (INSIGHT tier)
- [Generate Signal](https://rekko.ai/docs/api-reference/strategy/generate-signal): `POST /v1/signals` — AI trading signal with Kelly sizing (STRATEGY tier)
- [Portfolio Signal](https://rekko.ai/docs/api-reference/strategy/portfolio-signal): `POST /v1/signals/portfolio` — Portfolio-aware signal with correlation and hedge recs (STRATEGY tier)
- [Execution Guidance](https://rekko.ai/docs/api-reference/strategy/execution-guidance): `GET /v1/markets/{platform}/{market_id}/execution` — Optimal trade execution analysis (STRATEGY tier)
- [Arbitrage](https://rekko.ai/docs/api-reference/deep/arbitrage): `GET /v1/arbitrage` — Cached cross-platform arbitrage opportunities (DEEP tier)
- [Arbitrage Live](https://rekko.ai/docs/api-reference/deep/arbitrage-live): `GET /v1/arbitrage/live` — Fresh arbitrage scan, 10-30 seconds (DEEP tier)
- [Correlation](https://rekko.ai/docs/api-reference/deep/correlation): `POST /v1/correlation` — Cross-market correlation for portfolio diversification (DEEP tier)
- [Resolution](https://rekko.ai/docs/api-reference/deep/resolution): `GET /v1/markets/{platform}/{market_id}/resolution` — Resolution timing and time-value analysis (DEEP tier)
- [Calibration](https://rekko.ai/docs/api-reference/analytics/calibration): `GET /v1/calibration` — Signal accuracy metrics (free, no auth)
- [Sentiment](https://rekko.ai/docs/api-reference/analytics/sentiment): `GET /v1/sentiment` — Aggregate market sentiment snapshot (LISTING tier)
- [Performance](https://rekko.ai/docs/api-reference/analytics/performance): `GET /v1/performance` — Win rate, P&L, ROI metrics (LISTING tier)
- [Performance History](https://rekko.ai/docs/api-reference/analytics/performance-history): `GET /v1/performance/history` — Daily P&L time series (LISTING tier)
- [Consensus](https://rekko.ai/docs/api-reference/consensus/get-consensus): `GET /v1/markets/{platform}/{market_id}/consensus` — Aggregated agent consensus probability (INSIGHT tier)
- [Report Trade](https://rekko.ai/docs/api-reference/consensus/report-trade): `POST /v1/trades/report` — Report a trade for consensus aggregation (INSIGHT tier)
- [SSE Stream](https://rekko.ai/docs/api-reference/streaming/sse-stream): `GET /v1/stream` — Real-time Server-Sent Events (DEEP tier)
- [Create Webhook](https://rekko.ai/docs/api-reference/streaming/create-webhook): `POST /v1/webhooks` — Register event webhook (DEEP tier)
- [List Webhooks](https://rekko.ai/docs/api-reference/streaming/list-webhooks): `GET /v1/webhooks` — List your webhooks (DEEP tier)
- [Delete Webhook](https://rekko.ai/docs/api-reference/streaming/delete-webhook): `DELETE /v1/webhooks/{webhook_id}` — Remove a webhook (DEEP tier)
- [Signup](https://rekko.ai/docs/api-reference/customers/signup): `POST /v1/customers/signup` — Create free account, returns one-time API key
- [My Account](https://rekko.ai/docs/api-reference/customers/me): `GET /v1/customers/me` — Profile, usage stats, quota tracking

## Integrations

- [MCP Server](https://rekko.ai/docs/integrations/mcp/overview): Model Context Protocol plugin for AI coding assistants (25+ tools). Install: `uvx rekko-mcp`
- [Claude Code Setup](https://rekko.ai/docs/integrations/mcp/claude-code): Plugin install or manual .mcp.json config for Claude Code
- [Cursor Setup](https://rekko.ai/docs/integrations/mcp/cursor): Manual .cursor/mcp.json config for Cursor AI
- [MCP Tools Reference](https://rekko.ai/docs/integrations/mcp/tools-reference): Full list of 25+ MCP tools by category
- [RapidAPI](https://rekko.ai/docs/integrations/rapidapi/overview): Rekko on RapidAPI marketplace with proxy auth
- [OpenClaw](https://rekko.ai/docs/integrations/openclaw/overview): Rekko as an AI agent skill (brain for trading agents)
- [OpenClaw Quickstart](https://rekko.ai/docs/integrations/openclaw/quickstart): Install skill and get first signal in 5 minutes
- [OpenClaw Python Client](https://rekko.ai/docs/integrations/openclaw/python-client): RekkoClient async HTTP library with x402 support
- [x402 Micropayments](https://rekko.ai/docs/integrations/x402/overview): Per-request USDC payments on Base L2, no subscription

## Account

- [Dashboard](https://rekko.ai/docs/account/dashboard): API key management, usage stats, plan upgrades
- [Plans](https://rekko.ai/docs/account/plans): Free vs Pro vs Enterprise comparison
- [Rate Limits](https://rekko.ai/docs/account/rate-limits): 30 req/min (Free), 120 req/min (Pro), 5 req/min strategy
- [Quotas](https://rekko.ai/docs/account/quotas): Monthly call limits per tier, always-free endpoints

## Tutorials

- [Prediction Market API Comparison](https://rekko.ai/docs/guides/prediction-market-api-comparison): Kalshi vs Polymarket vs Robinhood vs Coinbase — authentication, endpoints, rate limits, Python SDKs, fees, and the unified Rekko layer
- [Build a Trading Bot with Python](https://rekko.ai/docs/guides/build-trading-bot-python): Step-by-step tutorial — screen markets, get AI analysis, generate signals with Kelly sizing, execute trades, track performance
- [Kalshi API Guide](https://rekko.ai/docs/guides/kalshi-api-guide): RSA-PSS authentication, REST endpoints, ticker format, order placement, market data, and adding AI analysis on top
- [Polymarket API Guide](https://rekko.ai/docs/guides/polymarket-api-guide): CLOB API, Gamma Markets API, py-clob-client SDK, condition IDs, HMAC auth, and AI-powered analysis
- [Cross-Platform Arbitrage](https://rekko.ai/docs/guides/prediction-market-arbitrage): Find price gaps between Kalshi and Polymarket, spread calculation, fee accounting, automated scanning, real-time alerts
- [MCP Trading Workflow](https://rekko.ai/docs/guides/mcp-trading-workflow): Use Rekko's 25+ MCP tools from Claude Code or Cursor — market screening, deep analysis, arbitrage, portfolio management via natural language
- [Kelly Criterion Position Sizing](https://rekko.ai/docs/guides/kelly-criterion-position-sizing): Full Kelly, half Kelly, portfolio Kelly with correlation adjustment, automated sizing via signals API
- [PredictIt Alternatives](https://rekko.ai/docs/guides/predictit-alternatives): PredictIt is winding down — where to trade prediction markets in 2026 (Kalshi, Polymarket, Robinhood)
- [Manifold Markets API](https://rekko.ai/docs/guides/manifold-markets-api-guide): Play-money prediction market API and when to use real-money platforms instead
- [Bayesian Analysis](https://rekko.ai/docs/guides/bayesian-analysis-prediction-markets): Prior estimation, evidence updating, causal factor decomposition, and automated Bayesian analysis via API
- [Webhooks and SSE Streaming](https://rekko.ai/docs/guides/webhooks-streaming): Real-time price shifts, whale alerts, analysis completions via Server-Sent Events and webhook push notifications

## Optional

- [Terms of Service](https://rekko.ai/terms-of-service): Usage terms and legal disclaimers
- [Privacy Policy](https://rekko.ai/privacy): Data collection and privacy practices
- [TikTok](https://www.tiktok.com/@rekko.ai): Daily 60-second prediction market video breakdowns
- [Discord](https://discord.gg/qTPEk9aAZg): Real-time market alerts and community
- [X / Twitter](https://x.com/RekkoAI): Market analysis threads
- [GitHub](https://github.com/Rekko-AI): Open-source tooling
- [rekko-mcp](https://github.com/Rekko-AI/rekko-mcp): MCP server for AI coding assistants (Claude Code, Cursor, Windsurf)
- [rekko-skill](https://github.com/Rekko-AI/rekko-skill): OpenClaw skill for autonomous trading agents

## Contact

- Email: contact@rekko.ai
- Dashboard: https://rekko.ai/dashboard