feat: Stockbit login for the order book, live quotes and daily history

Opt-in, with the user's own Stockbit session from a pasted credentialStorage cookie (or IDX_STOCKBIT_REFRESH_TOKEN): - idx stockbit login/status/logout; session file 0600, tokens never shown - rotating refresh under a cross-process lock; one refresh+retry on 401 - stocks orderbook: depth with lots and orders, OHLC, value, foreign flow - --provider stockbit quotes from the session API when logged in - --history-provider stockbit, and auto under the stockbit provider for 5d-1y daily windows - MCP get_orderbook and stockbit_status (17 tools) Endpoints, units and recorded responses from fzn0x/idx (MIT).
2026-11-07 09:45:36 +00:00 · 2026-10-23 08:35:57 +00:00 · 2026-10-23 08:35:57 +00:00 · b5ae9b98de
commit b5ae9b98de
parent 570439369e
61 changed files with 2882 additions and 129 deletions
--- a/crates/idx-cli/tests/golden/cases.toml
+++ b/crates/idx-cli/tests/golden/cases.toml
@ -263,6 +263,28 @@ args = ["stocks", "intraday", "MABA"]
 name = "stockbit-quote"
 args = ["--provider", "stockbit", "stocks", "quote", "BBCA,MABA"]

+# With a session: IDX_STOCKBIT_REFRESH_TOKEN seeds an unsigned test token that
+# expires in 2100; the mock serves the recorded exodus responses.
+
+[[case]]
+name = "stockbit-session-orderbook"
+args = ["stocks", "orderbook", "BBCA", "--depth", "3"]
+env = { IDX_STOCKBIT_REFRESH_TOKEN = "eyJhbGciOiJub25lIn0.eyJleHAiOiA0MTAyNDQ0ODAwLCAibm90ZSI6ICJ0ZXN0IHRva2VuLCBzaWduZWQgYnkgbm9ib2R5In0.c2ln" }
+
+[[case]]
+name = "stockbit-session-quote"
+args = ["--provider", "stockbit", "stocks", "quote", "BBCA"]
+env = { IDX_STOCKBIT_REFRESH_TOKEN = "eyJhbGciOiJub25lIn0.eyJleHAiOiA0MTAyNDQ0ODAwLCAibm90ZSI6ICJ0ZXN0IHRva2VuLCBzaWduZWQgYnkgbm9ib2R5In0.c2ln" }
+
+[[case]]
+name = "stockbit-session-history"
+args = ["--provider", "stockbit", "stocks", "history", "BBCA", "--period", "1mo"]
+env = { IDX_STOCKBIT_REFRESH_TOKEN = "eyJhbGciOiJub25lIn0.eyJleHAiOiA0MTAyNDQ0ODAwLCAibm90ZSI6ICJ0ZXN0IHRva2VuLCBzaWduZWQgYnkgbm9ib2R5In0.c2ln" }
+
+[[case]]
+name = "stockbit-status-logged-out"
+args = ["stockbit", "status"]
+
 # --- stocks: broker summaries (IPOT) and foreign flow (IDX) --------------------

 [[case]]
@ -366,6 +388,15 @@ args = ["stocks", "intraday", "ZZZZ"]
 name = "error-stockbit-fundamental-unsupported"
 args = ["--provider", "stockbit", "stocks", "fundamental", "BBCA"]

+[[case]]
+name = "error-orderbook-no-session"
+args = ["stocks", "orderbook", "BBCA"]
+
+[[case]]
+name = "error-stockbit-history-window"
+args = ["stocks", "history", "BBCA", "--period", "5y", "--history-provider", "stockbit"]
+env = { IDX_STOCKBIT_REFRESH_TOKEN = "eyJhbGciOiJub25lIn0.eyJleHAiOiA0MTAyNDQ0ODAwLCAibm90ZSI6ICJ0ZXN0IHRva2VuLCBzaWduZWQgYnkgbm9ib2R5In0.c2ln" }
+
 # --- ownership --------------------------------------------------------------------

 [[case]]
--- a/crates/idx-cli/tests/golden/completions-bash.golden
+++ b/crates/idx-cli/tests/golden/completions-bash.golden
@ -33,6 +33,9 @@ _idx() {
            idx,ownership)
                cmd="idx__ownership"
                ;;
+            idx,stockbit)
+                cmd="idx__stockbit"
+                ;;
            idx,stocks)
                cmd="idx__stocks"
                ;;
@ -102,6 +105,9 @@ _idx() {
            idx__help,ownership)
                cmd="idx__help__ownership"
                ;;
+            idx__help,stockbit)
+                cmd="idx__help__stockbit"
+                ;;
            idx__help,stocks)
                cmd="idx__help__stocks"
                ;;
@ -174,6 +180,15 @@ _idx() {
            idx__help__ownership__resolve,unresolved)
                cmd="idx__help__ownership__resolve__unresolved"
                ;;
+            idx__help__stockbit,login)
+                cmd="idx__help__stockbit__login"
+                ;;
+            idx__help__stockbit,logout)
+                cmd="idx__help__stockbit__logout"
+                ;;
+            idx__help__stockbit,status)
+                cmd="idx__help__stockbit__status"
+                ;;
            idx__help__stocks,bandar)
                cmd="idx__help__stocks__bandar"
                ;;
@ -210,6 +225,9 @@ _idx() {
            idx__help__stocks,news)
                cmd="idx__help__stocks__news"
                ;;
+            idx__help__stocks,orderbook)
+                cmd="idx__help__stocks__orderbook"
+                ;;
            idx__help__stocks,profile)
                cmd="idx__help__stocks__profile"
                ;;
@ -348,6 +366,30 @@ _idx() {
            idx__ownership__resolve__help,unresolved)
                cmd="idx__ownership__resolve__help__unresolved"
                ;;
+            idx__stockbit,help)
+                cmd="idx__stockbit__help"
+                ;;
+            idx__stockbit,login)
+                cmd="idx__stockbit__login"
+                ;;
+            idx__stockbit,logout)
+                cmd="idx__stockbit__logout"
+                ;;
+            idx__stockbit,status)
+                cmd="idx__stockbit__status"
+                ;;
+            idx__stockbit__help,help)
+                cmd="idx__stockbit__help__help"
+                ;;
+            idx__stockbit__help,login)
+                cmd="idx__stockbit__help__login"
+                ;;
+            idx__stockbit__help,logout)
+                cmd="idx__stockbit__help__logout"
+                ;;
+            idx__stockbit__help,status)
+                cmd="idx__stockbit__help__status"
+                ;;
            idx__stocks,bandar)
                cmd="idx__stocks__bandar"
                ;;
@ -387,6 +429,9 @@ _idx() {
            idx__stocks,news)
                cmd="idx__stocks__news"
                ;;
+            idx__stocks,orderbook)
+                cmd="idx__stocks__orderbook"
+                ;;
            idx__stocks,profile)
                cmd="idx__stocks__profile"
                ;;
@ -447,6 +492,9 @@ _idx() {
            idx__stocks__help,news)
                cmd="idx__stocks__help__news"
                ;;
+            idx__stocks__help,orderbook)
+                cmd="idx__stocks__help__orderbook"
+                ;;
            idx__stocks__help,profile)
                cmd="idx__stocks__help__profile"
                ;;
@ -475,7 +523,7 @@ _idx() {

    case "${cmd}" in
        idx)
-            opts="-o -q -v -V -h --output --no-color --quiet --verbose --provider --offline --no-cache --version --help stocks config cache ownership completions version help"
+            opts="-o -q -v -V -h --output --no-color --quiet --verbose --provider --offline --no-cache --version --help stocks config cache ownership stockbit completions version help"
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 1 ]] ; then
                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                return 0
@ -875,7 +923,7 @@ _idx() {
            return 0
            ;;
        idx__help)
-            opts="stocks config cache ownership completions version help"
+            opts="stocks config cache ownership stockbit completions version help"
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                return 0
@ -1266,8 +1314,64 @@ _idx() {
            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
            return 0
            ;;
+        idx__help__stockbit)
+            opts="login status logout"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__help__stockbit__login)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__help__stockbit__logout)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__help__stockbit__status)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
        idx__help__stocks)
-            opts="quote intraday history technical growth valuation risk fundamental broker bandar flow profile financials earnings sentiment insights news screen compare"
+            opts="quote intraday orderbook history technical growth valuation risk fundamental broker bandar flow profile financials earnings sentiment insights news screen compare"
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                return 0
@ -1448,6 +1552,20 @@ _idx() {
            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
            return 0
            ;;
+        idx__help__stocks__orderbook)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
        idx__help__stocks__profile)
            opts=""
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
@ -2392,8 +2510,182 @@ _idx() {
            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
            return 0
            ;;
+        idx__stockbit)
+            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help login status logout help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --output)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                -o)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                --provider)
+                    COMPREPLY=($(compgen -W "yahoo msn stockbit" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__help)
+            opts="login status logout help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__help__help)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__help__login)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__help__logout)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__help__status)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__login)
+            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --output)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                -o)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                --provider)
+                    COMPREPLY=($(compgen -W "yahoo msn stockbit" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__logout)
+            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --output)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                -o)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                --provider)
+                    COMPREPLY=($(compgen -W "yahoo msn stockbit" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
+        idx__stockbit__status)
+            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --output)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                -o)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                --provider)
+                    COMPREPLY=($(compgen -W "yahoo msn stockbit" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
        idx__stocks)
-            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help quote intraday history technical growth valuation risk fundamental broker bandar flow profile financials earnings sentiment insights news screen compare help"
+            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help quote intraday orderbook history technical growth valuation risk fundamental broker bandar flow profile financials earnings sentiment insights news screen compare help"
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 2 ]] ; then
                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                return 0
@ -2691,7 +2983,7 @@ _idx() {
            return 0
            ;;
        idx__stocks__help)
-            opts="quote intraday history technical growth valuation risk fundamental broker bandar flow profile financials earnings sentiment insights news screen compare help"
+            opts="quote intraday orderbook history technical growth valuation risk fundamental broker bandar flow profile financials earnings sentiment insights news screen compare help"
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
                return 0
@ -2886,6 +3178,20 @@ _idx() {
            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
            return 0
            ;;
+        idx__stocks__help__orderbook)
+            opts=""
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
        idx__stocks__help__profile)
            opts=""
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 4 ]] ; then
@ -3000,7 +3306,7 @@ _idx() {
                    return 0
                    ;;
                --history-provider)
-                    COMPREPLY=($(compgen -W "auto yahoo msn" -- "${cur}"))
+                    COMPREPLY=($(compgen -W "auto yahoo msn stockbit" -- "${cur}"))
                    return 0
                    ;;
                --output)
@ -3104,6 +3410,36 @@ _idx() {
            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
            return 0
            ;;
+        idx__stocks__orderbook)
+            opts="-o -q -v -h --depth --output --no-color --quiet --verbose --provider --offline --no-cache --help <SYMBOL>"
+            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
+                COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+                return 0
+            fi
+            case "${prev}" in
+                --depth)
+                    COMPREPLY=($(compgen -f "${cur}"))
+                    return 0
+                    ;;
+                --output)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                -o)
+                    COMPREPLY=($(compgen -W "auto table json jsonl" -- "${cur}"))
+                    return 0
+                    ;;
+                --provider)
+                    COMPREPLY=($(compgen -W "yahoo msn stockbit" -- "${cur}"))
+                    return 0
+                    ;;
+                *)
+                    COMPREPLY=()
+                    ;;
+            esac
+            COMPREPLY=( $(compgen -W "${opts}" -- "${cur}") )
+            return 0
+            ;;
        idx__stocks__profile)
            opts="-o -q -v -h --output --no-color --quiet --verbose --provider --offline --no-cache --help <SYMBOL>"
            if [[ ${cur} == -* || ${COMP_CWORD} -eq 3 ]] ; then
@ -3254,7 +3590,7 @@ _idx() {
            fi
            case "${prev}" in
                --history-provider)
-                    COMPREPLY=($(compgen -W "auto yahoo msn" -- "${cur}"))
+                    COMPREPLY=($(compgen -W "auto yahoo msn stockbit" -- "${cur}"))
                    return 0
                    ;;
                --output)
--- a/crates/idx-cli/tests/golden/error-orderbook-no-session.json.golden
+++ b/crates/idx-cli/tests/golden/error-orderbook-no-session.json.golden
@ -0,0 +1,4 @@
+exit: 4
+--- stdout
+--- stderr
+{"code":"AUTHERROR","error":true,"message":"auth error: no Stockbit session; run `idx stockbit login` (or set IDX_STOCKBIT_REFRESH_TOKEN)"}
--- a/crates/idx-cli/tests/golden/error-orderbook-no-session.table.golden
+++ b/crates/idx-cli/tests/golden/error-orderbook-no-session.table.golden
@ -0,0 +1,4 @@
+exit: 4
+--- stdout
+--- stderr
+Error: auth error: no Stockbit session; run `idx stockbit login` (or set IDX_STOCKBIT_REFRESH_TOKEN)
--- a/crates/idx-cli/tests/golden/error-stockbit-history-window.json.golden
+++ b/crates/idx-cli/tests/golden/error-stockbit-history-window.json.golden
@ -0,0 +1,4 @@
+exit: 5
+--- stdout
+--- stderr
+{"code":"UNSUPPORTED","error":true,"message":"unsupported: Stockbit history covers 5d to 1y of daily candles, not 5y at 1d; use --history-provider yahoo"}
--- a/crates/idx-cli/tests/golden/error-stockbit-history-window.table.golden
+++ b/crates/idx-cli/tests/golden/error-stockbit-history-window.table.golden
@ -0,0 +1,4 @@
+exit: 5
+--- stdout
+--- stderr
+Error: unsupported: Stockbit history covers 5d to 1y of daily candles, not 5y at 1d; use --history-provider yahoo
--- a/crates/idx-cli/tests/golden/help-root.golden
+++ b/crates/idx-cli/tests/golden/help-root.golden
@ -10,6 +10,7 @@ Commands:
  config       Manage configuration
  cache        Manage local cache
  ownership    Ownership intelligence (bootstrap with `ownership sync`)
+  stockbit     Your Stockbit session (opt-in: order book, live quotes)
  completions  Generate shell completions
  version      Show idx-cli version
  help         Print this message or the help of the given subcommand(s)
--- a/crates/idx-cli/tests/golden/help-stocks.golden
+++ b/crates/idx-cli/tests/golden/help-stocks.golden
@ -7,6 +7,7 @@ Usage: idx stocks [OPTIONS] <COMMAND>
 Commands:
  quote        Get real-time stock quotes
  intraday     Today's session price by the minute (Stockbit)
+  orderbook    Order book depth and foreign flow (Stockbit login)
  history      Get historical OHLC data
  technical    Run technical analysis on a stock
  growth       Run growth analysis on a stock
--- a/crates/idx-cli/tests/golden/stockbit-quote.table.golden
+++ b/crates/idx-cli/tests/golden/stockbit-quote.table.golden
@ -8,5 +8,5 @@ exit: 0
 │ MABA.JK ┆ 50    ┆ +0   ┆ +0.00% ┆ 0           ┆ -   ┆ -     ┆ close  ┆ -     │
 └─────────┴───────┴──────┴────────┴─────────────┴─────┴───────┴────────┴───────┘
 Note: MABA.JK: Stockbit lists the stock as suspended
-Source: Stockbit's public page, delayed at least 10 minutes (Stockbit's terms); bid/offer only while the market is open.
+Source: Stockbit, your session when logged in (`idx stockbit status`), else its public page, delayed at least 10 minutes (Stockbit's terms); bid/offer only while the market is open.
 --- stderr
--- a/crates/idx-cli/tests/golden/stockbit-session-history.json.golden
+++ b/crates/idx-cli/tests/golden/stockbit-session-history.json.golden
@ -0,0 +1,4 @@
+exit: 0
+--- stdout
+[{"date":"2026-09-17","open":6400,"high":6400,"low":6325,"close":6350,"volume":61812000},{"date":"2026-09-18","open":6325,"high":6350,"low":6225,"close":6300,"volume":176753700},{"date":"2026-09-21","open":6300,"high":6300,"low":6225,"close":6225,"volume":69914100},{"date":"2026-09-22","open":6225,"high":6250,"low":6175,"close":6200,"volume":93211200},{"date":"2026-09-23","open":6200,"high":6300,"low":6200,"close":6300,"volume":96826100},{"date":"2026-09-24","open":6250,"high":6275,"low":6225,"close":6225,"volume":75648600},{"date":"2026-09-25","open":6225,"high":6275,"low":6200,"close":6250,"volume":89447400},{"date":"2026-09-28","open":6225,"high":6250,"low":6175,"close":6225,"volume":112107600},{"date":"2026-09-29","open":6150,"high":6225,"low":6125,"close":6150,"volume":149783400},{"date":"2026-09-30","open":6100,"high":6150,"low":6050,"close":6075,"volume":221335700},{"date":"2026-10-01","open":6050,"high":6150,"low":6000,"close":6000,"volume":118044900},{"date":"2026-10-02","open":6000,"high":6150,"low":5975,"close":6100,"volume":131920300},{"date":"2026-10-05","open":6100,"high":6175,"low":6075,"close":6175,"volume":89905700},{"date":"2026-10-06","open":6175,"high":6200,"low":6100,"close":6100,"volume":152173400},{"date":"2026-10-07","open":6075,"high":6100,"low":5975,"close":6050,"volume":162690800},{"date":"2026-10-08","open":6100,"high":6150,"low":6000,"close":6000,"volume":113140300},{"date":"2026-10-09","open":6025,"high":6075,"low":5975,"close":6050,"volume":87098600},{"date":"2026-10-12","open":6050,"high":6100,"low":5950,"close":5950,"volume":97965100},{"date":"2026-10-13","open":5925,"high":5950,"low":5850,"close":5950,"volume":122716900},{"date":"2026-10-14","open":6000,"high":6125,"low":5950,"close":6125,"volume":136303100},{"date":"2026-10-15","open":6075,"high":6125,"low":6025,"close":6075,"volume":134763200},{"date":"2026-10-16","open":5825,"high":5825,"low":5175,"close":5175,"volume":1241098200}]
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-session-history.table.golden
+++ b/crates/idx-cli/tests/golden/stockbit-session-history.table.golden
@ -0,0 +1,51 @@
+exit: 0
+--- stdout
+History for BBCA.JK
+┌────────────┬───────┬───────┬───────┬───────┬───────────────┐
+│ DATE       ┆ OPEN  ┆ HIGH  ┆ LOW   ┆ CLOSE ┆ VOLUME        │
+╞════════════╪═══════╪═══════╪═══════╪═══════╪═══════════════╡
+│ 2026-09-17 ┆ 6,400 ┆ 6,400 ┆ 6,325 ┆ 6,350 ┆ 61,812,000    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-18 ┆ 6,325 ┆ 6,350 ┆ 6,225 ┆ 6,300 ┆ 176,753,700   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-21 ┆ 6,300 ┆ 6,300 ┆ 6,225 ┆ 6,225 ┆ 69,914,100    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-22 ┆ 6,225 ┆ 6,250 ┆ 6,175 ┆ 6,200 ┆ 93,211,200    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-23 ┆ 6,200 ┆ 6,300 ┆ 6,200 ┆ 6,300 ┆ 96,826,100    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-24 ┆ 6,250 ┆ 6,275 ┆ 6,225 ┆ 6,225 ┆ 75,648,600    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-25 ┆ 6,225 ┆ 6,275 ┆ 6,200 ┆ 6,250 ┆ 89,447,400    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-28 ┆ 6,225 ┆ 6,250 ┆ 6,175 ┆ 6,225 ┆ 112,107,600   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-29 ┆ 6,150 ┆ 6,225 ┆ 6,125 ┆ 6,150 ┆ 149,783,400   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-09-30 ┆ 6,100 ┆ 6,150 ┆ 6,050 ┆ 6,075 ┆ 221,335,700   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-01 ┆ 6,050 ┆ 6,150 ┆ 6,000 ┆ 6,000 ┆ 118,044,900   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-02 ┆ 6,000 ┆ 6,150 ┆ 5,975 ┆ 6,100 ┆ 131,920,300   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-05 ┆ 6,100 ┆ 6,175 ┆ 6,075 ┆ 6,175 ┆ 89,905,700    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-06 ┆ 6,175 ┆ 6,200 ┆ 6,100 ┆ 6,100 ┆ 152,173,400   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-07 ┆ 6,075 ┆ 6,100 ┆ 5,975 ┆ 6,050 ┆ 162,690,800   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-08 ┆ 6,100 ┆ 6,150 ┆ 6,000 ┆ 6,000 ┆ 113,140,300   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-09 ┆ 6,025 ┆ 6,075 ┆ 5,975 ┆ 6,050 ┆ 87,098,600    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-12 ┆ 6,050 ┆ 6,100 ┆ 5,950 ┆ 5,950 ┆ 97,965,100    │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-13 ┆ 5,925 ┆ 5,950 ┆ 5,850 ┆ 5,950 ┆ 122,716,900   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-14 ┆ 6,000 ┆ 6,125 ┆ 5,950 ┆ 6,125 ┆ 136,303,100   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-15 ┆ 6,075 ┆ 6,125 ┆ 6,025 ┆ 6,075 ┆ 134,763,200   │
+├╌╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌╌╌╌╌┤
+│ 2026-10-16 ┆ 5,825 ┆ 5,825 ┆ 5,175 ┆ 5,175 ┆ 1,241,098,200 │
+└────────────┴───────┴───────┴───────┴───────┴───────────────┘
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-session-orderbook.json.golden
+++ b/crates/idx-cli/tests/golden/stockbit-session-orderbook.json.golden
@ -0,0 +1,4 @@
+exit: 0
+--- stdout
+{"symbol":"BBCA.JK","name":"Bank Central Asia Tbk.","price":5175,"change":-900,"change_pct":-14.81,"prev_close":6075,"open":5825,"high":5825,"low":5175,"volume":1241098200,"value":6474934315000,"frequency":185072,"foreign_buy":1616461977500,"foreign_sell":3945955065000,"foreign_net":-2329493087500,"bids":[],"offers":[{"price":5175,"shares":264462500,"orders":3284},{"price":5200,"shares":10053400,"orders":337},{"price":5225,"shares":3711400,"orders":396}],"market_status":"STATE_NAME_MARKET_CLOSED","session_note":null}
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-session-orderbook.table.golden
+++ b/crates/idx-cli/tests/golden/stockbit-session-orderbook.table.golden
@ -0,0 +1,17 @@
+exit: 0
+--- stdout
+BBCA.JK Bank Central Asia Tbk. 5,175 -900 (-14.81%)
+prev close 6,075 · open 5,825 · high 5,825 · low 5,175 · volume 1,241,098,200 · value 6,474,934,315,000 · 185,072 trades
+foreign buy 1,616,461,977,500 · sell 3,945,955,065,000 · net -2,329,493,087,500
+market closed: the book as the market left it
+┌────────┬──────┬─────┬───────┬───────────┬────────┐
+│ ORDERS ┆ LOTS ┆ BID ┆ OFFER ┆ LOTS      ┆ ORDERS │
+╞════════╪══════╪═════╪═══════╪═══════════╪════════╡
+│        ┆      ┆     ┆ 5,175 ┆ 2,644,625 ┆ 3,284  │
+├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
+│        ┆      ┆     ┆ 5,200 ┆ 100,534   ┆ 337    │
+├╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌┼╌╌╌╌╌┼╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌╌╌╌┼╌╌╌╌╌╌╌╌┤
+│        ┆      ┆     ┆ 5,225 ┆ 37,114    ┆ 396    │
+└────────┴──────┴─────┴───────┴───────────┴────────┘
+Source: your Stockbit session; for personal, non-commercial use (Stockbit's terms).
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-session-quote.json.golden
+++ b/crates/idx-cli/tests/golden/stockbit-session-quote.json.golden
@ -0,0 +1,4 @@
+exit: 0
+--- stdout
+[{"symbol":"BBCA.JK","price":5175,"change":-900,"change_pct":-14.81,"volume":1241098200,"market_cap":null,"week52_high":null,"week52_low":null,"week52_position":null,"range_signal":null,"prev_close":6075,"avg_volume":null,"as_of":null,"behind_session":false,"market_status":"STATE_NAME_MARKET_CLOSED"}]
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-session-quote.table.golden
+++ b/crates/idx-cli/tests/golden/stockbit-session-quote.table.golden
@ -0,0 +1,9 @@
+exit: 0
+--- stdout
+┌─────────┬───────┬──────┬─────────┬───────────────┬─────┬───────┬────────┬───────┐
+│ SYMBOL  ┆ PRICE ┆ CHG  ┆ CHG%    ┆ VOLUME        ┆ BID ┆ OFFER ┆ MARKET ┆ AS OF │
+╞═════════╪═══════╪══════╪═════════╪═══════════════╪═════╪═══════╪════════╪═══════╡
+│ BBCA.JK ┆ 5,175 ┆ -900 ┆ -14.81% ┆ 1,241,098,200 ┆ -   ┆ -     ┆ closed ┆ -     │
+└─────────┴───────┴──────┴─────────┴───────────────┴─────┴───────┴────────┴───────┘
+Source: Stockbit, your session when logged in (`idx stockbit status`), else its public page, delayed at least 10 minutes (Stockbit's terms); bid/offer only while the market is open.
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-status-logged-out.json.golden
+++ b/crates/idx-cli/tests/golden/stockbit-status-logged-out.json.golden
@ -0,0 +1,4 @@
+exit: 0
+--- stdout
+{"logged_in":false,"access":{"present":false,"expires_at":null,"expires_in_secs":null},"refresh":{"present":false,"expires_at":null,"expires_in_secs":null},"session_file":"<ROOT>/config/idx/stockbit-session.json"}
+--- stderr
--- a/crates/idx-cli/tests/golden/stockbit-status-logged-out.table.golden
+++ b/crates/idx-cli/tests/golden/stockbit-status-logged-out.table.golden
@ -0,0 +1,8 @@
+exit: 0
+--- stdout
+logged in:     no
+access token:  none
+refresh token: none
+session file:  <ROOT>/config/idx/stockbit-session.json
+Run `idx stockbit login` to add one.
+--- stderr