SimpleFunctions

← DataReal-time

Live across the market universe,
six surfaces.

A single compressed world-state snapshot every 15 minutes for agent-native consumption. Ten topic RSS feeds plus four special feeds. Native MCP adapter. Same surfaces in the CLI. Public tier and contracted tiers.

Live

Markets

15 min

World-state cadence

14

RSS feeds

60/min

Rate limit per IP

Layer picker

Choose the right live layer.

The real-time product has different freshness and payload shapes. Agent context, indicator screening, per-market inspection, and low-latency streams should not point to the same URL.

Surfaces

Six ways to take the live feed.

01

World state

Single endpoint returning the entire prediction-market world model — top divergences, consensus breaks, movers, SimpleFunctions Index — in roughly 800 tokens. Built for AI agents that need compact, real-time context without scanning the full raw universe.

Endpoint
/api/agent/world
Cadence
15 min
Auth
No auth · 60 req/min per IP
curl simplefunctions.dev/api/agent/world
Agent integration
02

RSS / Atom feeds

Topic-scoped Atom feeds keyed to the same scan engine that powers /screen — built for LLM retrievers, RSS readers, and changelog tooling. Ten topic feeds plus four special feeds.

Endpoint
/api/agent/feed/{topic}
Cadence
On demand
Auth
No auth · ETag + Last-Modified
curl simplefunctions.dev/api/agent/feed/elections
Sample feed
03

MCP server

Model Context Protocol adapter for MCP-compatible hosts. Prefer CLI for local agents and HTTP/Data APIs for remote agents.

Endpoint
/api/mcp/mcp
Cadence
Live
Auth
Public read · key for write
claude mcp add simplefunctions --url https://simplefunctions.dev/api/mcp/mcp
AI agents guide
04

CLI

Same surfaces, terminal-native. Pipes cleanly to jq, tail, and shell agents. Read-only with no key; writes use a personal API key.

Endpoint
@spfunctions/cli
Cadence
Live · WebSocket optional
Auth
No auth for read · /dashboard/keys for write
npm i -g @spfunctions/cli && sf world
CLI overview
05

Live screen

Indicator-aware live screen across the full universe. Filter by IY, CRI, EE, LAS, RV, VR, IAR, category, venue, or keyword. Returns paginated JSON or HTML on /screen.

Endpoint
/api/public/screen
Cadence
Live · 60s pricing
Auth
No auth · 60 req/min per IP
curl "simplefunctions.dev/api/public/screen?iy_min=200&tau_max_days=30"
Open the screener
06

Search / query

Free-text search across the live universe with semantic ranking, plus three structured query surfaces — government bills, economic series, and policy events — that share the same query grammar.

Endpoint
/api/public/scan?q=…
Cadence
Live
Auth
No auth · 60 req/min per IP
curl "simplefunctions.dev/api/public/scan?q=fed%20rate"
Query surfaces

Feeds

Ten topics. Four specials. Atom + ETag.

Each topic feed wraps the live scan endpoint with the same query the search bar uses. Special feeds wrap the world-state snapshot. All return Atom 1.0 with proper Last-Modified and ETag headers for cheap revalidation.

Cadence

How fresh is each layer.

01Pricing + orderbook60 s
02Indicators (IY, CRI, EE, ...)60 s
03Live screen60 s
04World state aggregate15 min
05Hot-entity rankings60 min
06Regime classifier60 min
07Calibration scorecardsNightly
08HuggingFace datasetsDaily 06:00 UTC

FAQ

Frequently asked.

01

Do I need an API key for the real-time prediction-market data?

No. The world-state endpoint, RSS feeds, screen, scan, and per-market reads are public and rate-limited at 60 req/min per IP. Authenticated endpoints — intent submission, dashboards, autopilot — require an API key from /dashboard/keys.

02

How fresh is the data?

Pricing and orderbook state refresh every 60 seconds via the Cloudflare proxy layer. The indicator pipeline runs on the same cadence. The compressed world-state aggregate refreshes every 15 minutes. Hot-entity rankings refresh hourly. Calibration scorecards refresh nightly. The HuggingFace mirrors export at 06:00 UTC.

03

Can I stream the prediction-market data instead of polling?

For interactive use, the SimpleFunctions CLI maintains a WebSocket-style watch loop (sf world --watch). For programmatic agents, the recommended pattern is to poll /api/agent/world every 15 minutes — that is the cadence at which the underlying world model meaningfully changes. RSS readers can also rely on ETag + Last-Modified for cheap revalidation.

04

How do AI agents connect to the real-time prediction-market data?

Two paths. (1) MCP — claude mcp add simplefunctions --url https://simplefunctions.dev/api/mcp/mcp for Claude Code, Cursor, or any MCP client; gives the agent the current MCP catalog. (2) Plain REST — agents can hit /api/agent/world and the topic feeds directly with no MCP layer required. Both work without authentication for read access.

05

What is the difference between /api/agent/world and /api/public/screen?

/api/agent/world is a curated, compressed snapshot — top movers, divergences, consensus breaks, SimpleFunctions Index components — sized for an LLM context window. /api/public/screen is the raw indicator-aware filter over the current indicator universe with no compression; use it when you want every row that matches a specific indicator constraint.

Adjacent surfaces