Trade intents

​

Lifecycle

create  →  pending  →  active  →  filled | cancelled | expired

​

Create

sf intent buy KXRATECUT-26DEC31 100 --price 65 --thesis <id>
sf intent sell KXBTC100K 50 --price 30 --json

POST /api/intents
Authorization: Bearer sf_live_...
Content-Type: application/json

{
  "ticker": "KXRATECUT-26DEC31",
  "side": "yes",
  "action": "buy",
  "qty": 100,
  "priceCents": 65,
  "thesisId": "th_..."
}

​

List

sf intent list --json
sf intents --json --status active

​

Cancel

sf intent cancel <intent-id>

​

Reasons an intent can be rejected

• RISK_GATE_FAIL — exceeds per-market or per-day risk limits.
• STALE_PRICE — the price you specified is no longer reachable.
• INSUFFICIENT_BALANCE — Kalshi/Polymarket balance below what the order would require.
• CATEGORY_BLOCKED — your config excludes the market’s category (e.g., sports).
• THESIS_MISMATCH — the intent’s edge doesn’t match the linked thesis’s direction.

​

Execution

• portfolio-autopilot ticks if execution_mode = 'live'.
• manual execution via the web terminal trade ticket.
• direct CLI via sf buy / sf sell, which bypass the intent layer entirely.

​

Next steps