fzn0x/idx

Indonesian stock market (IDX / IHSG) analysis for people and AI agents.
One binary: a CLI that prints tables, a JSON mode for scripts, and an MCP server for agents.

---

idx stocks quote BBCA,BBRI,TLKM

╭────────┬──────────────────────────────┬───────┬──────┬─────────┬───────┬───────┬───────┬───────────────┬─────────┬───────┬────────╮
│ Symbol ┆ Name                         ┆ Price ┆ Chg  ┆ Chg %   ┆ Open  ┆ High  ┆ Low   ┆ Volume        ┆ Mkt Cap ┆ P/E   ┆ Div %  │
╞════════╪══════════════════════════════╪═══════╪══════╪═════════╪═══════╪═══════╪═══════╪═══════════════╪═════════╪═══════╪════════╡
│ BBCA   ┆ PT Bank Central Asia Tbk     ┆ 5,175 ┆ -900 ┆ -14.81% ┆ 5,825 ┆ 5,825 ┆ 5,175 ┆ 1,241,098,200 ┆  635.7T ┆ 10.96 ┆  6.27% │
│ BBRI   ┆ PT Bank Rakyat Indonesia (P… ┆ 2,640 ┆ -460 ┆ -14.84% ┆ 2,640 ┆ 2,890 ┆ 2,640 ┆ 1,193,916,400 ┆  397.8T ┆  6.49 ┆ 13.48% │
│ TLKM   ┆ Perusahaan Perseroan (Perse… ┆ 1,900 ┆ -330 ┆ -14.80% ┆ 1,900 ┆ 1,985 ┆ 1,900 ┆   963,614,200 ┆  187.3T ┆ 10.98 ┆ 10.01% │
╰────────┴──────────────────────────────┴───────┴──────┴─────────┴───────┴───────┴───────┴───────────────┴─────────┴───────┴────────╯
Last trade 2026-10-16 16:14 WIB · market closed · delayed data

idx -o json stocks quote BBCA | jq '.data[0] | {price, change_pct, pe_trailing, dividend_yield_pct}'

{ "price": 5175.0, "change_pct": -14.814815, "pe_trailing": 10.963983, "dividend_yield_pct": 6.27 }

• Free data, no keys. Yahoo Finance and MSN Money for prices and

• Built for agents. -o json emits a stable, schema-documented envelope

• Works offline. Responses are cached with per-endpoint TTLs; --offline

• Ownership, not just prices. KSEI's monthly register of holders above 1 %

• Single static binary. Rust, no runtime, Linux / macOS / Windows.

Install

The package is called ihsg-cli; the command it installs is idx (npm also adds ihsg-cli as an alias).

cargo install ihsg-cli                    # crates.io, builds from source (Rust 1.88+)
npm install -g github:fzn0x/idx           # npm, straight from this repository
npx github:fzn0x/idx stocks quote BBCA    # npm, no install
curl -fsSL https://raw.githubusercontent.com/fzn0x/idx/main/install.sh | sh   # Linux, macOS

npm installs a small launcher from this repository; the first idx command downloads the prebuilt binary for your platform from the matching GitHub release and checks it against the release's SHA256SUMS (so does install.sh). The binary is stored next to the launcher, or in a per-user cache when the global npm folder is not writable. On npm 12, which only installs from git when allowed, add --allow-git=all to the command.

Windows without npm: download idx--x86_64-pc-windows-msvc.zip from the releases page. Static Linux binaries are musl builds and run on any distribution. The development version installs with cargo install --git https://github.com/fzn0x/idx.

Shell completions:

idx completions bash > ~/.local/share/bash-completion/completions/idx
idx completions zsh  > ~/.zfunc/_idx
idx completions fish > ~/.config/fish/completions/idx.fish
idx completions powershell | Out-String | Invoke-Expression

Commands

| command | what it does | | --- | --- | | stocks quote | Delayed quote for one or many tickers (BBCA,BBRI or BBCA BBRI; .JK optional) | | stocks history [--period 1y] [--interval 1d] [--limit 30] | OHLCV candles with a summary line. Periods 1d 5d 1mo 3mo 6mo 1y 2y 5y 10y ytd max, intervals 5m 15m 30m 1h 1d 1wk 1mo | | stocks profile | Sector, industry, description, size, headquarters, management | | stocks financials [--period annual\|quarterly\|ttm] [--statement all\|income\|balance\|cash] | Income statement, balance sheet, cash flow | | stocks earnings | Quarterly EPS vs estimates with surprise, yearly revenue/earnings, next earnings date and consensus | | stocks dividends | Every cash dividend (ex-date, split-adjusted amount) and split; yearly totals, TTM total and yield, payout streak | | stocks returns [--benchmark ^JKSE] | 1w/1m/3m/6m/YTD/1y/3y/5y returns, CAGR, volatility, max drawdown, best/worst day, 52-week position, and excess over IHSG | | stocks brief | One page: quote, verdict, signal, returns vs IHSG, dividends, top holders, headlines, with plain-language key points | | stocks fundamental | P/E, P/B, PEG, EV/EBITDA, ROE, ROA, margins, leverage, growth, dividend, analyst targets, plus a plain-language verdict that lists every rule it applied | | stocks technical [--period 1y] | RSI, MACD, SMA/EMA 20/50/200, Bollinger, ATR, volume, support/resistance, trend, buy/sell/neutral signal with reasons | | stocks compare | Side-by-side fundamentals for two or more tickers | | stocks screen -f "pe<15,roe>15,sector=financial" | Screener over ~950 IDX tickers: one batch quote for valuation/size/dividend keys, per-company fundamentals for the rest (capped, largest first) | | stocks news [SYMBOL] [--company-only] [--source kontan\|cnbcindonesia\|all] | Headlines from Kontan and CNBC Indonesia RSS. With a ticker, the company's headlines come first, then market context fills the limit | | stocks sentiment | Aggregate lexicon sentiment over the matching headlines, with counts, terms and the strongest headlines | | stocks actions [--since D] | Corporate actions from IPOT, upcoming ones included: cash and stock dividends, splits, bonus shares, rights issues (amount, ratio old:new, cum, ex, recording and payment dates, status, announcement), shareholders' meetings (RUPS: time, venue, agenda), listed warrants and rights | | stocks foreign [--days 20] | Foreign buying and selling per session from idx.co.id (shares, as IDX publishes them), net, net × close, totals and the net-buy/net-sell streak | | stocks list [--board B] [--search S] | Listed stocks from idx.co.id with listing board, listing date and shares; the bundled universe stands in offline | | ownership import --latest\|--all\|--file F\|--url U | Import KSEI's monthly ">1 % holders" register (XLSX or PDF) into local SQLite. --latest/--all read idx.co.id and fall back to the CI-maintained GitHub mirror | | ownership ticker [--as-of D] | Holders above 1 % of a ticker | | ownership entity "" [--as-of D] | Every position of a person or institution, spelling variants grouped | | broker [--date D \| --from D --to D] [--investor all\|foreign\|domestic] [--board all\|regular\|cash\|negotiated] | Broker summary: the top 10 buyers and sellers of a ticker (ranked by lots), with broker name, class (local, foreign, BUMN), lots, value and average price, plus total value and foreign net. Latest session with trades by default; -o csv gives one row per broker | | bandar detect [--period 1d\|1w\|1m\|3m] [--top 1\|3\|5\|10] [--daily] | Bandarmology: are the top brokers accumulating or distributing? The top 1/3/5/10 buyers against as many sellers (bandar value and volume), net as a share of the value traded, the phase against the price move, the top buyers' average against the price, foreign flow; --daily adds the bandar movement session by session. See Bandarmology | | bandar screen [--preset P] [-f FILTER] [--period P] [--scan N] | Bandarmology screener over the 100 most traded stocks by value: presets big-accumulation, accumulation, distribution, big-distribution, quiet-accumulation, quiet-distribution, foreign-accumulation, below-bandar, or filters on acc, net, fnet, fpct, gain, chg, turnover, conc, signal, phase | | bandar broker [--period P] [--scan N \| --symbols S] | Broker activity: where one broker (e.g. YP) sits among the top 10 buyers or sellers of the 100 most traded stocks, with rank, lots, value, average, share of the stock's value and net where both sides are visible | | market overview [--top 10] | IHSG, breadth, turnover, gainers, losers, most traded, heavyweights from one pass over the universe | | market foreign [--date D] [--top 10] [--sort value\|shares] | Top foreign net buying and net selling across every stock for one session (idx.co.id), with the market's foreign totals | | market brokers [--date D] [--top 20] [--sort value\|volume\|frequency] | Every exchange member's trading for one session, ranked, with each member's share of all members' value | | market indices [CODE...] [--date D] | Every IDX index (IHSG, LQ45, IDX30, sector and thematic) for one session: close, change, range, constituents, value, market cap | | market calendar [--from D --to D \| --date D] [--symbol S] [--type T] | The exchange calendar: dividend and rights dates (cum, ex, recording, payment), RUPS, public exposes, listings; bonds and buyback reports with --type all. Default: the next 14 days | | market holidays [--year Y \| --all] [--upcoming] | Trading holidays (Kalender Libur Bursa, bundled), the year's trading days, whether today is a trading day and the next one | | market members [--search S] | Exchange members (broker codes) with names and licences | | ownership changes --from D --to D [--symbol S] [--min-change PP] [--limit N --offset N] | New holders, exits and position changes between two months, paged, with a summary (counts, foreign vs local net, by investor type, issuer flow, top moves) over every match | | ownership foreign [SYMBOL] [--from D --to D] | Disclosed foreign (KSEI A) vs local stake: one issuer month by month, or every issuer's change between two months | | watch [add\|rm\|list\|clear\|returns] | Plain-text watchlist next to the config; idx watch quotes it | | ownership releases\|discover\|path | Imported months, files published on idx.co.id, database path | | mcp [--http ADDR --token T] · mcp setup | MCP server over stdio or streamable HTTP, and the registration recipe for 25 agent harnesses. 36 tools: idx_brief, idx_market, idx_quote, idx_history, idx_profile, idx_financials, idx_earnings, idx_dividends, idx_returns, idx_fundamental, idx_technical, idx_compare, idx_screen, idx_news, idx_sentiment, idx_corporate_actions, idx_foreign, idx_instruments, idx_market_foreign, idx_market_brokers, idx_indices, idx_calendar, idx_holidays, idx_members, idx_broker, idx_bandar, idx_bandar_screen, idx_bandar_broker, idx_ownership_ticker, idx_ownership_entity, idx_ownership_changes, idx_ownership_foreign, idx_ownership_releases, idx_orderbook, idx_stockbit_status, idx_stockbit_login | | schema [name] | JSON Schema for every payload (quotes, history, profile, fundamentals, compare, financials, earnings, dividends, returns, market, brief, technical, screen, news, sentiment, actions, foreign, instruments, market-foreign, market-brokers, indices, calendar, holidays, members, broker, bandar, bandar-screen, bandar-broker, ownership-*, watchlist, error, ...) | | config init\|set\|get\|path | Config file management | | cache stats\|clear\|path | Response cache management | | completions | bash, zsh, fish, powershell, elvish | | version | Version, build and default paths |

idx -o json stocks history TLKM --period 1y --interval 1wk \
  | jq '.data.summary.change_pct'

idx mcp setup --list          # every supported client
idx mcp setup codex           # prints: codex mcp add idx -- /abs/path/idx mcp
idx mcp setup muse            # prints the settings.json block Meta's Muse Code expects

idx bandar detect BBCA                         # last week, top 5 vs top 5
idx bandar detect BBRI --period 1m --daily     # with the bandar movement
idx bandar screen --preset quiet-accumulation  # buying while the price stalls
idx bandar screen -f 'acc>=5,fpct>=5,gain<0'   # with foreigners, under the bandar's average