Documentation Index
Fetch the complete documentation index at: https://rekko.ai/docs/llms.txt
Use this file to discover all available pages before exploring further.
Base URL
Authentication
All endpoints require a Bearer token. See Authentication for details.
Authorization: Bearer rk_free_your_key_here
Endpoint tiers
Each endpoint requires a minimum subscription tier.
| Tier | Endpoints | Per-call cost |
|---|
| LISTING | Markets, prices, history | $0.01 |
| INSIGHT | Analysis, screening, resolution | $0.10 |
| STRATEGY | Signals, execution, portfolio | $2.00 |
| DEEP | Arbitrage, correlation, webhooks, streaming | $5.00 |
- All request bodies are JSON (
Content-Type: application/json)
- Query parameters use standard URL encoding
- Market identifiers follow the pattern:
{platform}/{market_id} where platform is kalshi, polymarket, or robinhood
All responses are JSON. Successful responses return 200 OK or 202 Accepted (for async operations).
Error responses
| Status | Meaning |
|---|
400 | Bad request — invalid parameters |
401 | Unauthorized — missing or invalid API key |
403 | Forbidden — tier too low for this endpoint |
404 | Not found — market or resource doesn’t exist |
429 | Too many requests — rate limit or quota exceeded |
502 | Bad gateway — upstream platform unavailable |
{
"detail": "Human-readable error message"
}
Async analysis pattern
Analysis endpoints use an async pattern because research pipelines run 30-90 seconds:
- Trigger:
POST /v1/markets/{platform}/{market_id}/analyze returns 202 with analysis_id
- Poll:
GET .../analyze/{analysis_id}/status until status is "complete"
- Retrieve:
GET /v1/markets/{platform}/{market_id}/analysis for the full result
Expandable fields
Many endpoints support ?expand= to include additional nested data:
| Expansion | Available on | Description |
|---|
causal | Analysis, signals | Causal factor decomposition |
scenarios | Analysis | Outcome scenario breakdown |
meta | Analysis | Methodology metadata |
history | Analysis, markets | Price history |
scoring | Arbitrage | Spread quality scoring breakdown |
