api
23 live
1 future
Endpoint reference.
Every alphakernel HTTP endpoint the site consumes. Live endpoints drive the running pages; future endpoints are sketched in ADR-0059 (the operator-workspace data contract) and feed pages that today render against build-time fixtures.
Live endpoints follow the soft-fail contract from ADR-0052: on 404 / 503, the consuming page renders em-dashes + an editorial offline ribbon. The akClient wrapper (ADR-0051) is the single source of fetch policy (timeout, retry, signal composition — ADR-0053).
bot · 13
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
| live | Per-currency NAV with live-mark versus cost-basis provenance. Drives the morning briefing primary-currency tile. | /desk /bot | — | |
/v1/bot/pnl/today
curl -s "$AK_BASE/v1/bot/pnl/today" | jq .
|
live | Today's realized PnL. Drives the desk PnL tile + /bot realized-pnl panel. | /desk /bot | — |
/v1/bot/cash
curl -s "$AK_BASE/v1/bot/cash" | jq .
|
live | Cash balances per currency. | /bot | — |
/v1/bot/cashflows?limit=20
curl -s "$AK_BASE/v1/bot/cashflows?limit=20" | jq .
|
live | Recent cashflow events (deposits, withdrawals). | /bot | — |
/v1/bot/corp-actions?limit=20
curl -s "$AK_BASE/v1/bot/corp-actions?limit=20" | jq .
|
live | Recent corporate actions (splits, dividends). | /bot | — |
/v1/bot/fills?limit=20
curl -s "$AK_BASE/v1/bot/fills?limit=20" | jq .
|
live | Recent fills. | /bot | — |
/v1/bot/lots
curl -s "$AK_BASE/v1/bot/lots" | jq .
|
live | Open tax-lots. | /bot | — |
/v1/bot/marks?limit=20
curl -s "$AK_BASE/v1/bot/marks?limit=20" | jq .
|
live | Recent mark-to-market events. | /bot | — |
/v1/bot/orders?limit=20
curl -s "$AK_BASE/v1/bot/orders?limit=20" | jq .
|
live | Open + recently-closed orders. | /bot | — |
/v1/bot/positions
curl -s "$AK_BASE/v1/bot/positions" | jq .
|
live | Open positions. | /bot | — |
/v1/bot/attribution
curl -s "$AK_BASE/v1/bot/attribution" | jq .
|
live | PnL attribution by cited research note. | /bot | ADR-0013 |
/v1/bot/provenance
curl -s "$AK_BASE/v1/bot/provenance" | jq .
|
live | Citation set for each order. Audit trail for ADR-0011. | /bot /writing/<slug> | ADR-0011 |
/v1/bot/provenance-citers
curl -s "$AK_BASE/v1/bot/provenance-citers" | jq .
|
live | Reverse-citation index — which orders cite a given note. | /writing/<slug> | — |
data · 1
universes · 1
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
/v1/universes
curl -s "$AK_BASE/v1/universes" | jq .
|
live | Registered universes + today's member counts. | /universes | — |
discovery · 2
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
/v1/discovery/runs?limit=50
curl -s "$AK_BASE/v1/discovery/runs?limit=50" | jq .
|
live | Recent sweep / feature-search / factor-mining runs. | /desk /workspace | — |
/v1/discovery/runs/<id>
curl -s "$AK_BASE/v1/discovery/runs/<id>" | jq .
|
live | Per-run leaderboard + provenance. | /workspace/run/<id> | — |
stale · 1
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
/v1/bot/stale-theses
curl -s "$AK_BASE/v1/bot/stale-theses" | jq .
|
live | Theses flagged as declining or abandoned by the live-decay monitor. | /desk /writing/stale | ADR-0014 |
features · 2
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
/v1/features/leaderboard?limit=N
curl -s "$AK_BASE/v1/features/leaderboard?limit=20" | jq .
|
live | Per-feature aggregate (appearances, best/avg score, run ids) over the most-recent N persisted discovery runs. Live mirror of /features/leaderboard.json. | /features | ADR-0059 |
/v1/features/<feature>/ic?window=Nd
curl -s "$AK_BASE/v1/features/momentum_5/ic?window=20d" | jq .
|
future | Time-series of IC + decay rate for one feature. Lands in the "live IC" aside. | /features/<feature> | ADR-0059 |
strategies · 2
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
/v1/strategies/active?days=N
curl -s "$AK_BASE/v1/strategies/active?days=20" | jq .
|
live | Strategies with closing-leg attribution over the last N days; window PnL, last-decision time, cited notes per strategy. | /strategies | ADR-0059 |
/v1/strategies/<slug>/health?days=N
curl -s "$AK_BASE/v1/strategies/xs_momentum_live/health?days=20" | jq .
|
live | Per-strategy attribution snapshot — window PnL, last decision, cited notes. Filters /v1/strategies/active to one slug; present=false when no attribution in window. | /strategies/<slug> | ADR-0059 |
promotions · 2
| endpoint | status | summary | consumed by | adr |
|---|---|---|---|---|
/v1/promotions/recent
curl -s "$AK_BASE/v1/promotions/recent" | jq .
|
live | Thesis-lifecycle snapshot bucketed by status (active / exploratory / superseded). Live mirror of /promotions/lifecycle.json. | /promotions | ADR-0059 |
/v1/operator/summary?days=N
curl -s "$AK_BASE/v1/operator/summary?days=20" | jq .
|
live | Composite summary aggregating bot + data + discovery + manifest counts, including primary-NAV cost-basis provenance. One request instead of N parallel polls. | /desk | ADR-0059 |