stockbit-status

Stockbit session status

Report whether the stored session is alive, and what to do if it is not.

Run

stockbit-auth status --json

If the bin is not on PATH, run node dist/bin/stockbit-auth.js status --json from the repo root.

Prefer --json: it is redacted and safe to paste, and it spares you parsing prose. Add --offline when the user only wants expiry arithmetic without a network round-trip — offline can report a token as stored that the server would reject, so it answers "when does this expire", never "is this still good".

Read the report

{
  "auth": {
    "main":       { "stored": true,  "expiresInDays": 7 },  // the market-data session
    "securities": { "stored": false },                      // trading; optional
    "eipo":       { "stored": false }                       // minted on first use
  },
  "trading": { "mode": "off", "live": false, "enabled": false },
  "store": {
    "loggedInAt": "2026-08-26T08:15:28.943Z",  // when `stockbit-auth login` last ran
    "loginAgeHours": 19.7,                     // how long ago, for the user's actual question
    "browserPinned": "chrome.exe 152.0.7977.64",
    "defaultBrowser": "C:\...\opera.exe",    // what the OS opens links with
    "defaultBrowserIsPinned": false
  }
}

• auth.main is the one every market-data tool depends on. stored: false, or a failed live check, means every stockbit tool will fail until the user logs in again — see the stockbit-auth skill.
• expiresInDays counts down a sliding window. Every refresh pushes it back out, so ordinary use keeps the session alive indefinitely; only a long idle gap forces a new login. Warn when it is under 2.
• auth.securities is only needed for portfolio, positions and orders. stored: false is the normal, safer state — do not treat it as a problem to fix unless the user asked for trading.
• trading.mode is the thing to state plainly. off means no orders can be placed at all. If it is paper, say so. If it is live, say that first and clearly — with live: true the order tools reach a real brokerage account.