Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.simplefunctions.dev/llms.txt

Use this file to discover all available pages before exploring further.

The world model is the fastest way to give an agent current prediction-market context. Start with a snapshot, use query for task-specific search, inspect the markets that matter, then poll deltas instead of reloading the whole world.

​
Start here

curl "https://simplefunctions.dev/api/agent/world?format=json"
curl "https://simplefunctions.dev/api/agent/world/delta?since=1h&format=json"
curl "https://simplefunctions.dev/api/agent/inspect/KXRATECUT-26DEC31"
CLI equivalents: 
sf world --json
sf world --delta --json --since 1h
sf inspect KXRATECUT-26DEC31 --json

​
What to call

NeedHTTPCLI
Cold-start contextGET /api/agent/world?format=jsonsf world --json
Topic drillGET /api/agent/world/iran/hormuz?format=jsonsf world iran/hormuz --json
Recent changesGET /api/agent/world/delta?since=1h&format=jsonsf world --delta --json --since 1h
One market dossierGET /api/agent/inspect/{ticker}sf inspect <ticker> --json
Task-specific searchGET /api/public/query?q=Fed%20rate%20cutsf query "Fed rate cut" --json

​
Agent loop

sf world --json
sf query "Fed rate cut" --json --limit 3
sf inspect KXRATECUT-26DEC31 --json
sf world --delta --json --since 1h
Use the snapshot for the agent’s context window. Use query when the user asks about a specific event. Use inspect before acting on one ticker. Use delta for recurring jobs.

​
Snapshot

GET /api/agent/world?format=json
The JSON snapshot includes:
FieldUse
regionCurrent world path, such as root or iran/hormuz.
regimeMarket-wide label and signals.
salient[]Ranked items the agent should notice.
indexBack-compatible SF Index fields.
traditional[]Traditional-market anchors when available.
movers[]Back-compatible notable movers.
opportunities[]Back-compatible opportunity-like signals.
marketCountCount of salient items in the response.
servedAtResponse timestamp.
Example: 
curl "https://simplefunctions.dev/api/agent/world?format=json&limit=10"

​
Drill paths

Path segments narrow the world model. 
curl "https://simplefunctions.dev/api/agent/world/iran?format=json"
curl "https://simplefunctions.dev/api/agent/world/iran/hormuz?format=json"
CLI: 
sf world iran --json
sf world iran/hormuz --json
Use drill paths when an agent already knows the topic and needs a smaller context object.

​
Operations

op changes the view while keeping the response shaped as a world snapshot.
OperationHTTPCLI
Snapshot/api/agent/world?op=snapshot&format=jsonsf world --op snapshot --json
Catalyst window/api/agent/world/iran?op=catalyst&window=7d&format=jsonsf world iran --op catalyst --json
Dispersion/api/agent/world/iran?op=dispersion&format=jsonsf world iran --op dispersion --json
History/api/agent/world/iran?op=history&dt=24h&format=jsonsf world iran --op history --dt 24h --json
Trail/api/agent/world?op=trail&from=KXHORMUZ&format=jsonsf world --op trail --from KXHORMUZ --json
Explain item/api/agent/world?op=explain&item=s-7&format=jsonsf world --op explain --item s-7 --json
Useful parameters:
ParameterUse
format=jsonMachine-readable JSON. Defaults to markdown if omitted.
since=12hOverride baseline where supported. Accepts relative duration or ISO timestamp.
dt=24h or window=7dWindow for history/catalyst views.
depth=0..3Drill expansion depth.
limit=1..30Number of salient items.
focus=energyLegacy alias for a first drill path.

​
Delta

GET /api/agent/world/delta?since=1h&format=json

{
  "from": "2026-04-30T08:00:00.000Z",
  "to": "2026-04-30T08:15:00.000Z",
  "changes": [
    "- SF Index: Disagreement 49->52",
    "- NEW opportunity [contagion_gap]: ..."
  ],
  "markdown": "# World Delta — 08:00->08:15 UTC\n- ...",
  "latencyMs": 32
}
If changes is empty, keep the previous snapshot and continue the loop.

​
Inspect

GET /api/agent/inspect/{ticker}

curl "https://simplefunctions.dev/api/agent/inspect/KXRATECUT-26DEC31"
Inspect returns the detailed object an agent needs before it acts on a market:
FieldUse
ticker, venue, title, price, statusMarket identity and current state.
suggestionAction suggestion, confidence, reasoning, positives, warnings, size hint.
regimeMarket regime score and signals.
indicatorsIY, CRI, EE, LAS, overround, and related computed fields when available.
edges[]Thesis-derived edges linked to the ticker.
contagion[]Connected markets to inspect next.
trend7d[]Recent price trend when available.
legislationLinked government context when available.
nextActionsURLs for execution intents, monitoring, deeper inspection, or query follow-ups.
Options: 
curl "https://simplefunctions.dev/api/agent/inspect/KXRATECUT-26DEC31?format=markdown"
curl "https://simplefunctions.dev/api/agent/inspect/KXRATECUT-26DEC31?contagion=false&trend=false"
curl "https://simplefunctions.dev/api/agent/inspect/KXRATECUT-26DEC31?nextActions=off"

​
Feed

GET /api/agent/world/feed
The feed is Atom XML for subscribers that want the latest world snapshots without polling JSON directly. 
curl "https://simplefunctions.dev/api/agent/world/feed"
Use it for RSS readers, automation tools, crawlers, and agent frameworks that ingest feeds.

World State API

Endpoint parameters and response shapes.

Query API

Natural-language event search.

Market Detail API

Public market detail endpoint.

Agentic CLI

Local command equivalents for agents.