idx
Analyze the Indonesian stock market (IDX/IHSG) from web terminal, CLI, or any AI agents via MCP server. IHSG Prices, Fundamentals, and Screening. Free and No AP
What is idx?
Analyze the Indonesian stock market (IDX/IHSG) from web terminal, CLI, or any AI agents via MCP server. IHSG Prices, Fundamentals, and Screening. Free and No API keys required. Changelog: https://github.com/fzn0x/idx/blob/main/CHANGELOG.md
Overview of idx
What it is
A command-line tool and MCP server for analyzing the Indonesian stock market (IDX/IHSG). It provides delayed quotes, fundamentals, screening, ownership data, broker summaries, and more. The tool is free, requires no API keys, and works as a single static binary on Linux, macOS, and Windows. It can be used interactively in a terminal, in scripts via JSON output, or by AI agents through an MCP server.
Key features
- Free data from multiple sources (Yahoo Finance, MSN Money, idx.co.id, KSEI, Indo Premier, Kontan, CNBC Indonesia) with automatic fallback between providers.
- Built for agents:
-o jsonoutputs stable, schema-documented JSON;idx mcpexposes every command as a typed MCP tool. - Works offline: responses are cached with per-endpoint TTLs;
--offlineserves cached data when the network is unavailable. - Ownership analysis: imports KSEI's monthly register of holders above 1% into local SQLite, enabling queries by ticker or entity.
- Single static binary: written in Rust, no runtime dependencies, available for Linux, macOS, and Windows.
- Comprehensive commands: quotes, history, financials, earnings, dividends, returns, fundamentals, technical analysis, screener, news, sentiment, corporate actions, foreign flow, broker summary, and bandarmology.
Use cases
- Retrieve delayed stock quotes and historical OHLCV candles for IDX-listed companies.
- Analyze fundamentals (P/E, P/B, ROE, margins, etc.) and compare multiple tickers side by side.
- Screen over 900 IDX tickers using valuation, size, and dividend criteria.
- Monitor foreign buying/selling activity and broker-level accumulation or distribution (bandarmology).
- Track corporate actions (dividends, splits, rights issues) and shareholder meetings.
- Import and query the KSEI ownership register to see who holds more than 1% of a stock.
- Integrate with AI agents via the MCP server for automated market analysis.
Getting started
Install the ihsg-cli package (the command is idx): sh cargo install ihsg-cli npm install -g github:fzn0x/idx npx github:fzn0x/idx stocks quote BBCA For Linux/macOS, you can also use the install script: sh curl -fsSL https://raw.githubusercontent.com/fzn0x/idx/main/install.sh | sh Shell completions for bash, zsh, fish, and PowerShell are available via idx completions.
License and pricing
Licensed under MIT. The tool is open source and free to use; no API keys are required.
Based on the project's public README and repository metadata.