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 fundamentals, the exchange's own idx.co.id summaries for foreign flow, member activity, indices and the corporate-action calendar, IDX's monthly KSEI register for ownership, Indo Premier's broker summary for who bought and sold (read as bandarmology by idx bandar) and for foreign flow in rupiah (stocks foreign --source ipot), its corporate-action pages, Kontan and CNBC Indonesia feeds for news. Every source sits behind a Provider trait, so one breaking does not take the tool down, and auto fills gaps in one source's fundamentals from the other.
• Built for agents. -o json emits a stable, schema-documented envelope (idx schema quotes), -o jsonl one record per line. Exit codes mean something, and - reads tickers from stdin so commands chain. idx mcp exposes every command as a typed MCP tool that returns the very same JSON.
• Works offline. Responses are cached with per-endpoint TTLs; --offline serves the cache instead of failing when the network is gone.
• Ownership, not just prices. KSEI's monthly register of holders above 1 % is imported into local SQLite with normalised entity names, so "who owns more than 1 % of BBCA" and "what did this fund change last month" are one command each. The monthly IDX files are mirrored to GitHub, so neither you nor the web terminal imports anything by hand: idx ownership sync installs every month in one download.
• 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 --locked ihsg-cli           # crates.io, builds from source (Rust 1.89+)
npm install -g ihsg-cli                   # npm
npx ihsg-cli stocks quote BBCA            # npm, no install
curl -fsSL https://raw.githubusercontent.com/fzn0x/idx/main/install.sh | sh   # Linux, macOS
nix profile install github:fzn0x/idx      # Nix (Linux; Apple silicon macOS untested), with shell completions
nix run github:fzn0x/idx -- stocks quote BBCA   # Nix, no install

npm installs a small launcher; 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. npm install -g github:fzn0x/idx installs the same launcher from this repository's main; npm 12 only installs from git with --allow-git=all.

Windows without npm: download idx-<version>-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.

Nix builds idx from source on your machine (there is no binary cache), so the first nix profile install or nix run takes several minutes. The bare github:fzn0x/idx ref follows main; add a release tag to pin one, as in github:fzn0x/idx/v0.8.2 (the first release with the flake). For MCP clients, install once and register $HOME/.nix-profile/bin/idx, written as an absolute path, with the argument mcp: idx mcp setup prints the binary's resolved /nix/store path, which an upgrade followed by garbage collection removes. nix run github:fzn0x/idx#mcp starts the same server without installing, for trying it from a terminal; do not make it a client's server command, because a cold start (the first run, or the first after main moves) builds idx before the server answers, which takes longer than clients wait. overlays.default adds pkgs.idx for NixOS and home-manager configurations, and nix develop in a clone gives the toolchain from rust-toolchain.toml plus Node for web/. On NixOS, point idx stockbit login at a browser with IDX_BROWSER=$(command -v chromium).

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

Global flags work anywhere on the line:

For scripts and agents

idx -o json stocks history TLKM --period 1y --interval 1wk \
  | jq '.data.summary.change_pct'
idx -o jsonl market holidays --year 2026 | jq -r .date      # one record per line
idx -o jsonl stocks screen -f 'pe<10,roe>15' -n 5 | idx stocks compare -
echo BBCA BBRI | idx stocks quote -                         # tickers from stdin
idx -q -o csv stocks quote BBCA BBRI > quotes.csv           # stderr: errors only

• stdout carries exactly one JSON document (-o json) or one JSON record per line (-o jsonl); everything else goes to stderr. Errors are one JSON line on stderr in both modes.
• -o auto (or IDX_OUTPUT=auto) prints a table on a terminal and the JSON envelope when stdout is piped or captured.
• - in a ticker list (stocks quote|returns|compare, broker, bandar, watch add|rm) reads tickers from stdin: plain text (spaces, commas or lines, # comments) or idx's own -o json / -o jsonl output.
• The envelope records provider, fetched_at, cached, stale, stale_reason (offline or fetch_failed, only when stale) and warnings.
• Fields the source did not return are null. Nothing is estimated.
• Quotes carry behind_session: true when the last trade is dated before the latest IDX session that has ended (a suspended stock, one that did not trade, or a source that lags the close), using the bundled holiday calendar.
• Exit codes: 0 ok · 2 usage · 3 network/provider (JSON code blocked when the source's bot protection, Cloudflare, refused the request) · 4 not found · 5 offline cache miss · 6 config.

Full field reference: docs/json-output.md. Configuration and cache: docs/configuration.md. Calling idx from an agent (rules, exit codes, recipes, an agent-led install): docs/agent-guide.md.

MCP server

idx mcp serves the Model Context Protocol over stdio, which is what every local agent launches. idx mcp --http serves the same tools over streamable HTTP for products that only connect to a URL. idx mcp setup <client> prints the exact command or config snippet for your agent with the absolute path of the binary filled in, because GUI apps rarely inherit your shell PATH:

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

A bare idx in the table assumes the binary is on PATH; idx mcp setup substitutes the absolute path, and --npx swaps in npx -y ihsg-mcp: the npm package ihsg-mcp runs idx mcp without installing idx, fetching the release binary on first start and checking it against the release's SHA256SUMS (cmd /c npx -y ihsg-mcp on Windows; from this repository npx -y github:fzn0x/idx mcp still works). Each entry's remote (HTTP) form and the config file locations are in docs/mcp.md.

claude mcp add --scope user idx -- npx -y ihsg-mcp   # no idx install needed (Node 18+)
npx -y ihsg-mcp setup cursor                         # any client's recipe, in the npx form

The server lists 47 tools with typed input schemas kept to the subset every harness accepts (no nullable type arrays, no format or default keywords) and one-paragraph descriptions. idx_brief is the one-call starting point; idx_fundamental takes an optional lens (growth, valuation or risk) for the focused readings of stocks growth|valuation|risk; each tool returns the same envelope as -o json, so an agent that learned the CLI already knows the tools. Failures come back as tool errors carrying {error: {code, message}, exit_code}.

Bandarmology

"Bandar" is market slang for the big, concentrated money that moves a stock. idx bandar reads it from the IPOT broker summary, whose top 10 buyers and top 10 sellers are ranked by lots. For N = 1, 3, 5 and 10 the top N buyers' value minus the top N sellers' value is the bandar value (in lots, the bandar volume); its share of all value traded is the reading, with the headline on the top 5 (--top):

Quiet accumulation is the usual "bandar buying quietly": concentrated buying while the price stalls or falls. Each reading also gives the top buyers' average price against the last price (bandar_gain_pct: below zero they sit under water), how much of the value the top buyers took, the foreign net flow, and the rules in plain words (reasons). --daily adds the session series with its cumulative net and streak. The thresholds were set against the 40 most traded stocks in October 2026, where about half of single sessions read neutral. They are heuristics, not advice.

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

Astrology

idx market astro is traditional astrology done carefully: the positions are astronomy, computed on this machine from JPL's Keplerian elements (Standish), Schlyter's Jupiter-Saturn terms and Meeus's lunar theory, and checked in the tests against JPL Horizons (Sun and Moon within 0.01°, planets within 0.04°, 1800-2050) and the USNO moon phases (within 2 minutes). The Javanese weton (day, pasaran, neptu) and the Chinese shio (Imlek computed from new moons and solar terms, checked against the published dates 1924-2050) come with it, and IHSG's own chart is cast for noon WIB on its launch (1983-04-01) or base date (1982-08-10, value 100), dates from secondary sources (Antara, Bisnis.com, CEIC) not yet confirmed against an IDX publication.

--backtest asks whether any of it shows up in the index: IHSG's daily returns grouped by lunar phase, Mercury retrograde or direct, pasaran and Sun sign, each group tested against all other days (Welch's t, Bonferroni over the 27 groups). On every session from 1990-04-09 to 2026-11-04 (8,904 returns) no group passes Bonferroni; the nominal p < 0.05 groups (full moon -0.07 % a day, Capricorn +0.19 %, Pisces -0.10 %, Leo -0.09 %) are the lunar-effect and month-of-year patterns the finance literature already knows, since Sun signs follow the calendar. v1 prints no interpretations; it is not a forecast or investment advice.

idx market astro                          # today: planets, Moon, Mercury, weton, shio
idx market astro --date 2026-12-24 --days 7
idx market astro --backtest               # every session since 1990
idx -o json market astro --backtest --period 10y | jq '.data.backtest.factors[0]'

Data sources

Prices from the free sources are delayed as published; Stockbit is realtime for your own account. This tool is for research and tooling; it is not investment advice and not affiliated with IDX, KSEI, Yahoo, Microsoft or Stockbit.

Web terminal

https://ihsg.midoriresearch.com is the market page: IHSG and its session, breadth, the heavyweights and the most active stocks, refreshed every minute, with a stock search. It speaks Bahasa Indonesia at / and English at /en/, with the numbers in each language's style, and follows the device's light or dark setting.

https://ihsg.midoriresearch.com/terminal (English: /en/terminal) runs the same commands in a browser, no install: brief BBCA, quote BBCA,BBRI, intraday BBCA, returns BBCA BBRI, screen pe<10,div>5,mcap>5T --sort div, screen --preset top-performers, insights BBCA, news ASII, ownership ticker BBCA, ownership foreign, bandar BBCA --daily, bandar screen --preset big-accumulation, bandar broker YP, actions BBCA, foreign BBCA (foreign flow from IPOT in rupiah, up to 20 sessions), holidays --upcoming, astro, list --search bank, members, risk TLKM (also growth and valuation), brokers (market brokers from IPOT's ranking of its latest session, with each member's class and net), market foreign (market foreign --source ipot: the session's 100 most traded stocks by their foreign net in rupiah, from the nightly bandar scan, with IPOT's market totals), and tools (every MCP tool as a button). The idx.co.id commands (market-wide foreign flow in shares, the calendar, indices, and market brokers --source idx) are CLI and MCP only, because idx.co.id refuses requests from Cloudflare Workers; so, for now, is ownership institutions, until MSN is checked from the Worker. Typed into the terminal, any of these, and the CLI-only commands (watch, mcp, ownership import, ...), answer with a notice instead of an error: where the command runs and why, its CLI line with your own arguments, and the nearest command the page has. A line pasted from the CLI, such as idx stocks quote BBCA or idx -o json market overview, runs as the page's own command. quote with one symbol also draws a price chart (1D, 5D, 1M, 6M, YTD, 1Y, 5Y) with volume, the previous close and a crosshair readout. The web bandar screen and bandar broker read a scan the Worker runs after each close, once IPOT publishes the session's broker lists, over the session's 100 most traded stocks; their warnings say when an older session is shown. The CLI scans live. A Cloudflare Worker refreshes a D1 snapshot of the whole IDX board every minute in trading hours and serves /api/* with the exact JSON envelopes the CLI prints; everything else is fetched on demand and cached. The Worker lives in web/ and answers on the custom domain only (workers_dev = false, Host check in the Worker).

The same site serves this README and docs/ as https://ihsg.midoriresearch.com/docs/, every page also as Markdown at its .md address (/docs/mcp.md), with /llms.txt and /llms-full.txt for language models. They are built from the repository at deploy time.

Ownership data pipeline

Nobody imports the KSEI register by hand, and nothing outside the repository can write it:

1. .github/workflows/ownership.yml runs at 08:17, 14:17 and 20:17 WIB. It fetches the IDX "Data Kepemilikan Saham" page through a browser-impersonating client, downloads any new or re-published "Pemegang Saham di Atas 1%" workbook, imports every month with idx to prove it parses, and publishes the files plus index.json and parsed JSON parts to the ownership-data prerelease. idx.co.id blocks cloud networks, GitHub's own runners included, so the job runs on a self-hosted runner (an always-on machine with an ordinary connection; set the repository variable OWNERSHIP_RUNNER to self-hosted). On GitHub's runners it rebuilds the parts and the snapshot from the files already mirrored, and turns red once the newest register is 45 days old. From the same database it builds a prebuilt SQLite snapshot (snapshot-v{V}.json plus a gzip of the file) and publishes it whenever its content changes, the manifest last.
2. The web terminal's Worker reads that release on its minute cron: it checks index.json every 30 minutes, verifies each part's SHA-256 and loads one part per minute into D1. A month appears only once all its rows are in and the count matches. The newest six months are kept. The Worker has no write endpoint at all.
3. idx ownership sync on your machine installs that snapshot (a few MB, SHA-256 checked, swapped in as one SQLite transaction) and imports any newer month from the raw files; a database holding months the snapshot lacks is kept unless --force.
4. idx ownership import --latest tries idx.co.id and, when Cloudflare refuses it, downloads the same file from the mirror and checks its SHA-256. IDX_OWNERSHIP_SOURCE=mirror skips idx.co.id.

Development

cargo build
cargo test                                 # recorded fixtures, no network
cargo clippy --all-targets -- -D warnings
./scripts/smoke.sh                         # live providers

Architecture, conventions and "how to add a provider" live in AGENTS.md. Contributions: CONTRIBUTING.md.

License

MIT