API Documentation

Kairos Showcase exposes public JSON endpoints for portfolio data, leaderboard rankings, and embeddable widgets.

Quickstart

Get started with three lines of code. All public endpoints return JSON with no authentication required.

# Leaderboard — ranked portfolios
curl https://showcase.optionwheel.io/api/leaderboard/

# Portfolio chart data (30-day NAV series)
curl https://showcase.optionwheel.io/api/portfolio/1/chart/

# Recent trade history
curl https://showcase.optionwheel.io/api/trades/history/

JSON Endpoints

GET /api/portfolio/<id>/metrics/

Portfolio performance metrics (NAV, returns, Sharpe ratio)

GET /api/portfolio/<id>/chart/

NAV history chart data (JSON time series)

GET /api/leaderboard/

Portfolio leaderboard rankings

GET /api/trades/history/

Recent trade history with P&L

Requires: Staff
GET /api/positions/ticker/<ticker>/

Current position by ticker symbol

Requires: Staff
GET /api/pulse/

System health and market status

GET /embed/portfolio/<slug>/

Embeddable portfolio card (iframe)

GET /embed/leaderboard/

Embeddable leaderboard widget

GET /embed/ticker/

Embeddable ticker lookup widget

GET /embed/chart/<slug>/

Embeddable NAV chart widget

Embeddable Widgets

Add Kairos Showcase widgets to your website with a simple iframe. Visit the Embed Code Generator for copy-paste code snippets.

Rate Limits

Public endpoints are rate-limited to 60 requests per minute per IP. Data is cached for 5 minutes. For higher limits, upgrade to Intelligence tier.