Simplefunctions

What is Simplefunctions?

Simplefunctions is a prediction market intelligence CLI that lets you build causal thesis models, scan Kalshi and Polymarket for mispricings, detect trading edges, and execute trades—all from the terminal. It is designed for traders, analysts, and AI agents who need structured market research and execution.

How to use Simplefunctions?

Install the CLI globally with npm install -g @spfunctions/cli, then run sf setup to configure your SF API key (required) and optionally Kalshi credentials for positions/trading. Use commands like sf list, sf context <id> --json, sf edges, and sf scan to manage theses, explore markets, and trade. Most commands support --json for machine‑readable output.

Key features of Simplefunctions

• Manage theses with causal trees, confidence scores, and edges
• Scan Kalshi markets by keyword, series, or ticker
• View top mispricings across all theses with sf edges
• Trade contracts via sf buy/sf sell (requires Kalshi credentials)
• Inject news signals and trigger deep re‑evaluations
• Interactive agent mode and Telegram bot for monitoring

Use cases of Simplefunctions

• Build and monitor causal thesis models for prediction markets
• Scan markets for mispricings and detect trading edges
• React to breaking news by injecting signals and re‑evaluating theses
• Execute trades from the terminal based on thesis‑driven insights
• Automate market intelligence for AI coding agents

FAQ from Simplefunctions

What is the SF_API_KEY and why is it required?

The SF_API_KEY is your Simplefunctions API key, required for all CLI operations. You can obtain one at simplefunctions.dev and set it via sf setup or the environment variable SF_API_KEY.

Do I need Kalshi credentials to use Simplefunctions?

No. Kalshi credentials are optional—they enable commands for positions, orderbook, and trading (sf positions, sf buy, sf sell, etc.). Without them, thesis management and market scanning still work.

How do I get the full thesis state as JSON?

Run sf context <thesisId> --json. This returns a JSON object with the thesis title, confidence, causal tree, edges (mispricings), and latest evaluation summary.

What do the edge values mean in the output?

Edges represent the mispricing size in cents. A positive edge means the market is underpriced relative to the thesis model’s price. The marketPrice and thesisPrice fields show the current market price and the model’s target price (both 0–100).

Can I use Simplefunctions as an AI coding agent?

Yes. The README includes a dedicated agent section. Install and configure the CLI, then use sf list to verify, sf context <id> --json to read thesis state, and sf signal/sf evaluate to inject data and trigger analysis. Error handling is documented for common issues like missing API keys.