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 json outputs stable, schema-documented JSON; idx mcp exposes every command as a typed MCP tool.
  • Works offline: responses are cached with per-endpoint TTLs; --offline serves 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.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/fzn0xidx.svg)](https://yunodb.com/tools/fzn0xidx?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/fzn0xidx?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/fzn0xidx.svg" alt="Featured on YunoDB" height="20"></a>