Signals Feed API

docs/API.md

Signals Feed API

A read-only JSON feed of every signal the engine generates — identical content for every subscriber, informational only, not investment advice. Simulated (paper) signals unless explicitly labeled live.

Access

Tokens are issued by the operator (mix kalshi.token mint "<your name>") and shown once. Pass yours either way:

GET /api/signals?token=kt_...
GET /api/signals            (header: Authorization: Bearer kt_...)

Response

{
  "signals": [
    {
      "id": 412,
      "strategy": "momentum_fifteen",
      "market_ticker": "KXBTC15M-26AUG161000-00",
      "side": "yes",
      "action": "buy",
      "price_cents": 44,
      "count": 3,
      "confidence": 0.57,
      "status": "executed",
      "rationale": "15m open-window: p=0.57 (model n=2841) yes_ask=44",
      "at": "2026-08-16T14:02:11Z"
    }
  ],
  "disclaimer": "..."
}

Latest 100 signals, newest first. status is the engine's own disposition (executed = it took the paper/live trade itself, rejected = failed its risk checks). confidence is the model probability behind the signal; calibration against realized outcomes is published at /performance.

Terms

  • Signals are generated by automated strategies for research purposes.
  • Content is standardized: every subscriber receives the same data at the same time. Nothing is tailored to any recipient.
  • No performance guarantee; see the disclosures on /performance.
  • Tokens are personal; sharing or resale voids access.