Skip to main content
These endpoints summarise the prediction-market universe rather than a single ticker. Most are public reads — auth is optional but unlocks higher rate limits.

SimpleFunctions Index

GET /api/public/index
GET /api/public/index/history
The SimpleFunctions Index aggregates disagreement, geopolitical risk, fiscal stress, monetary policy, and tail-risk signals into a single time series and component breakdown. See SimpleFunctions Index methodology.
curl "https://simplefunctions.dev/api/public/index"
curl "https://simplefunctions.dev/api/public/index/history?days=90"
/history query params: days (default 30, max 365), theme (optional sub-component filter).

Regime

GET /api/public/regime/scan
Detect current market state changes, flow shifts, and monitor candidates. See Regime.
curl "https://simplefunctions.dev/api/public/regime/scan"
GET /api/public/regime/history is deprecated and returns 410 Gone. Regime score is now computed at query time from a static classification prior, so per-ticker regime history is not a meaningful time series. For spread/depth history use:
curl "https://simplefunctions.dev/api/public/market-microstructure-history?ticker=KXRATECUT-26DEC31&days=7"

Calendar

GET /api/public/calendar
Structured upcoming catalysts — econ releases, FOMC, elections, settlements. Used by sf calendar and sf milestones.

Trade ideas

GET /api/public/ideas
GET /api/public/ideas/{id}
Daily idea pipeline output. See Idea pipeline.

Calibration

GET /api/calibration
Auth: required. Authorization: Bearer sf_live_... or browser session. Returns calibration scorecards — how well prices have predicted realised outcomes over the requested window. Used by sf calibration and visible in the dashboard. Query parameters
ParameterTypeDefaultNotes
sourcestringallkalshi, polymarket, or omit for all venues.
periodstring30d7d, 30d, 90d, all.
categorystringoptionalTop-level category filter (macro, geo, monetary, …).
topicstringoptionalTopic-level filter (fed_rates, …).
min_volumenumberoptionalExclude markets below this dollar volume.
The /api/public/calibration alias re-exports this GET endpoint without auth and is used by external crawlers — it is the same response shape but rate-limited.
curl -H "Authorization: Bearer $SF_API_KEY" \
  "https://simplefunctions.dev/api/calibration?period=90d&min_volume=10000"

# public alias (no auth)
curl "https://simplefunctions.dev/api/public/calibration?period=30d"

Edges

GET /api/edges
Auth: required. Returns the current set of mispriced edges across the market universe — prices that diverge from SimpleFunctions’s model. Used by sf edges and the dashboard edge feed. Query parameters
ParameterTypeNotes
limitintMax edges, default 25.
minStrengthnumberFilter by SimpleFunctions edge strength score.
themestringRestrict to a theme.
venuestringkalshi | polymarket.
curl -H "Authorization: Bearer $SF_API_KEY" \
  "https://simplefunctions.dev/api/edges?limit=10&minStrength=0.6"

See also

SimpleFunctions Index methodology

How the index is constructed.

Calibration concept

Regime, calibration, and indicators in context.

Public market data

Per-market reads under /api/public/*.

Snapshots

Public HuggingFace exports.