tbot-client

Subscriber-side client for T BOT signal feed. Polls your operator's signal API, applies your local size config, and places orders against your own broker accounts.

T BOT operator never touches your funds, never sees your broker credentials, and never executes trades on your behalf. This client is what does the work on your machine.

---

What it does

1. Polls /api/signals/feed every 30 seconds using your subscriber token.
2. For each new signal:
   • Computes your dollar size: your_bankroll × signal.kelly_size_pct.
   • Routes to the appropriate broker adapter (Kalshi / OANDA / IBKR), if you've enabled that surface.
   • Places the order with the same direction + size as the signal.
   • POSTs an ack callback with accepted / filtered / stale.
   • If filled, POSTs executed with your fill price + size.
   • On position close, POSTs resolved with your realized P&L.
3. Skips signals where:
   • Surface is disabled in your config.
   • You're at your concurrent-positions cap for that surface.
   • The signal is past its 600-second TTL.
   • Your bankroll is below the broker's minimum order size.

Install

git clone https://github.com/{{operator_handle}}/tbot-client.git
cd tbot-client
python -m venv venv && source venv/bin/activate
pip install -r requirements.txt
cp config.example.yaml config.yaml
# Edit config.yaml — paste your subscriber token, choose surfaces, enter broker creds
python -m tbot_client

Recommend running under systemd or pm2 for production. See deploy/ for sample unit files.

Configuration

See config.example.yaml for the full schema. Minimal valid config:

operator:
  feed_url: "https://ops.tbot.trade/api/signals/feed"
  subscriber_token: "tbot_..."     # from your welcome email

surfaces:
  forex:
    enabled: true
    bankroll: 1000.0
    broker: oanda
    oanda:
      account_id: "001-001-12345-001"
      api_token: "..."             # your own OANDA token
      practice: true               # start in OANDA practice mode

  kalshi_st:
    enabled: false                 # opt in by setting true
  kalshi_lt:
    enabled: false
  stocks:
    enabled: false

Dry-run mode

Set dry_run: true at any surface level (or globally under runtime:) to log signals without placing orders. Recommended for the first 24-48 hours so you can verify routing before risking real money.

Logs

• ~/.tbot/client.log — verbose decision trace (chatty by design)
• ~/.tbot/state.json — local high-water marks + concurrent-position tracker

Failure modes

Symptom	Likely cause	What to do
HTTP 401 from feed	Token revoked by operator	Email operator
HTTP 401 from broker	Broker token expired	Renew on your broker's site, update config
"reason": "stale" ack repeatedly	Client clock out of sync OR network slow	Check date -u; reduce poll interval
"reason": "insufficient_funds"	Surface bankroll < broker minimum	Top up that broker account
Signals received but never executed	dry_run: true somewhere, or surface disabled	Check config

License

Provided as-is to T BOT beta subscribers. No warranty. Not investment advice. See TBOT_TERM_SHEET_v2.md (sent separately).