Skip to main content

​
Base URL

​
Authentication

All endpoints require a Bearer token. See Authentication for details.

​
Endpoint tiers

Each endpoint requires a minimum subscription tier.

​
Request format

  • 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

​
Response format

All responses are JSON. Successful responses return 200 OK or 202 Accepted (for async operations).

​
Error responses

Error body:

​
Async analysis pattern

Analysis endpoints use an async pattern because research pipelines run 30-90 seconds:
  1. Trigger: POST /v1/markets/{platform}/{market_id}/analyze returns 202 with analysis_id
  2. Poll: GET .../analyze/{analysis_id}/status until status is "complete"
  3. Retrieve: GET /v1/markets/{platform}/{market_id}/analysis for the full result

​
Expandable fields

Many endpoints support ?expand= to include additional nested data: