# Sectors API

> REST API and MCP server for Indonesian (IDX), Singapore (SGX) and Malaysian (KLSE) stock data: financials, prices, broker flows, screeners and news.

- [IDX, SGX & KLSE Stock Data API and MCP Server](https://docs.sectors.app/index.md): REST API and MCP server for Indonesia (IDX), Singapore (SGX) and Malaysia (KLSE) stock data: financials, prices, broker flows, screeners and news.
- [Get Started with Sectors API v2](https://docs.sectors.app/get-started/v2/overview.md): Get an API key, make your first request and explore v2 endpoints for Indonesian (IDX), Singapore (SGX) and Malaysian (KLSE) company data, prices and broker activity.
- [IDX API: Indonesia Stock Exchange Data API](https://docs.sectors.app/idx-api.md): REST API for Indonesia Stock Exchange (IDX) data: daily prices, company reports, quarterly financials, broker summary, foreign flow and a stock screener. JSON over HTTPS.
- [SGX API: Singapore Exchange Stock Data API](https://docs.sectors.app/sgx-api.md): REST API for Singapore Exchange (SGX) stock data: daily prices, company reports, a stock screener with plain-English queries, short sell, buybacks, insider filings and news. JSON over HTTPS.
- [Migration Guide: v1 to v2](https://docs.sectors.app/get-started/v2/migration-guide.md): Step-by-step guide to migrate from Sectors Financial API v1 to v2
- [Companies Screener](https://docs.sectors.app/api-references/v2/indonesia/screener/companies.md): IDX stock screener API: filter and sort Indonesian stocks (IDX) by sector, market cap, valuation, dividend yield and financial ratios.
- [Free Float Market Analysis](https://docs.sectors.app/api-references/v2/indonesia/screener/free-float.md): Returns the free float percentage for IDX-listed companies, optionally filtered by one level of the sector taxonomy. Results are ordered by `free_float` descending.
- [Companies with Revenue Segments](https://docs.sectors.app/api-references/v2/indonesia/helper-list/companies-segments-list.md): Returns a dictionary of all companies that have revenue and cost segment data available, along with their available financial years.
- [Latest Quarterly Financial Dates (Universe)](https://docs.sectors.app/api-references/v2/indonesia/helper-list/latest-quarterly-dates.md): Returns the **latest** available quarterly report date (and its quarter label) for **every** IDX company in one paginated feed — instead of calling the per-symbol [Quarterly Financial Dates](https://docs.sectors.app/api-references/v2/indonesia/helper-list/company-quarterly-dates) helper once per tic…
- [Quarterly Financial Dates](https://docs.sectors.app/api-references/v2/indonesia/helper-list/company-quarterly-dates.md): Returns all available quarterly financial report dates for a given symbol, grouped by year. Use the `report_date` values returned here as inputs to the `report_date` parameter in the Quarterly Financials endpoint.
- [Industries](https://docs.sectors.app/api-references/v2/indonesia/helper-list/industries.md): Returns all available subsector/industry pairs as kebab-case slugs. Use these values as inputs to the `industry` parameter.
- [Subindustries](https://docs.sectors.app/api-references/v2/indonesia/helper-list/subindustries.md): Returns all available industry/sub-industry pairs as kebab-case slugs. Use these values as inputs to the `sub_industry` parameter.
- [Subsectors](https://docs.sectors.app/api-references/v2/indonesia/helper-list/subsectors.md): Returns all available sector/subsector pairs as kebab-case slugs. Use these values as inputs to `sector` and `sub_sector` parameters.
- [News Tags](https://docs.sectors.app/api-references/v2/indonesia/helper-list/tags.md): Returns a sorted alphabetical array of all available tag slugs used across news articles and company filings. Use these values as inputs to the `tags` parameter.
- [Corporate Actions](https://docs.sectors.app/api-references/v2/indonesia/company/corporate-actions.md): <Note>IDX symbol: 4 letters, optionally followed by `.jk` (case-insensitive). E.g. `BBCA`, `BMRI`, `TLKM`.</Note>
- [Company Revenue Segments](https://docs.sectors.app/api-references/v2/indonesia/report/company-segments.md): Returns a Sankey-graph-ready revenue and cost segment breakdown for a given company and financial year. Not all companies have segment data — use the [Companies with Revenue Segments](https://docs.sectors.app/api-references/v2/indonesia/helper-list/companies-segments-list) endpoint to check availabi…
- [Company Report](https://docs.sectors.app/api-references/v2/indonesia/report/company-report.md): Returns a comprehensive company report organized into distinct sections. By default all sections are included. Use `sections` to request only the data you need and reduce response size.
- [Shareholders Composition](https://docs.sectors.app/api-references/v2/indonesia/company/shareholders-composition.md): <Note>IDX symbol: 4 letters, optionally followed by `.jk` (case-insensitive). E.g. `BBCA`, `BMRI`, `TLKM`.</Note>
- [Company Quarterly Financials](https://docs.sectors.app/api-references/v2/indonesia/report/quarterly-financials.md): Returns quarterly financial data for a given IDX symbol. Fields vary by sector — financial-sector companies (banks, insurance) have additional metrics like `net_interest_income`, `gross_loan`, `total_deposit`.
- [Subsector Report](https://docs.sectors.app/api-references/v2/indonesia/report/sector-report.md): Returns a comprehensive report for an IDX subsector, organized into distinct sections. Use `sections` to fetch only the data you need.
- [Daily Full-Universe Close](https://docs.sectors.app/api-references/v2/indonesia/transaction/close.md): Returns the daily closing price for **every** IDX ticker on a single trading day, in one paginated feed — instead of calling the per-symbol [Daily Transaction Data](https://docs.sectors.app/api-references/v2/indonesia/transaction/daily) endpoint once per ticker.
- [Daily Transaction Data](https://docs.sectors.app/api-references/v2/indonesia/transaction/daily.md): Returns daily close price, volume, and market cap for a given IDX symbol over a date range of up to 90 days.
- [IDX Market Summary](https://docs.sectors.app/api-references/v2/indonesia/transaction/idx-total.md): Returns historical total IDX market capitalization for a date range of up to 90 days.
- [Daily Full-Universe Index Close](https://docs.sectors.app/api-references/v2/indonesia/transaction/index-daily-universe.md): Returns the closing level of **every** IDX index on a single trading day in one call — instead of calling the per-index [Index Daily Transaction Data](https://docs.sectors.app/api-references/v2/indonesia/transaction/index-daily) endpoint once per index.
- [Index Daily Transaction Data](https://docs.sectors.app/api-references/v2/indonesia/transaction/index-daily.md): Returns daily closing price for a given IDX index over a date range of up to 90 days.
- [Top Company Movers](https://docs.sectors.app/api-references/v2/indonesia/ranking/top-changes.md): Returns top gainers and losers across multiple time periods. Supports two classifications (`top_gainers`, `top_losers`) and five periods (`1d`, `7d`, `14d`, `30d`, `365d`).
- [Most Traded Stocks](https://docs.sectors.app/api-references/v2/indonesia/ranking/most-traded.md): Returns the most traded IDX stocks by transaction volume over a date range of up to 90 days. Results are keyed by date.
- [Company IPO & Listing Performance](https://docs.sectors.app/api-references/v2/indonesia/ipo/listing-performance.md): Returns price change percentages since listing date for a given IDX-listed symbol, across 7, 30, 90, and 365-day windows.
- [Corporate Actions Calendar](https://docs.sectors.app/api-references/v2/indonesia/news/corporate-actions.md): Corporate actions across every IDX ticker in a date window, grouped by type: the market-wide counterpart of the per-symbol [Corporate Actions](https://docs.sectors.app/api-references/v2/indonesia/company/corporate-actions) endpoint. Row keys match the per-symbol endpoint. `start`/`end` filter (and s…
- [Company Filings](https://docs.sectors.app/api-references/v2/indonesia/news/filings.md): Returns IDX insider trading filings — buy/sell transactions by company insiders and major shareholders. Supports filtering by sector, subsector, tags, symbol, transaction type, holder_type, and date range.
- [News Articles](https://docs.sectors.app/api-references/v2/indonesia/news/news.md): Returns paginated news articles from either the IDX (Indonesian Stock Exchange) or mining news sources. Use the `extension` parameter to choose the data source — each extension has its own set of valid filter parameters.
- [Stock Suspensions](https://docs.sectors.app/api-references/v2/indonesia/news/suspensions.md): Returns a paginated list of historical IDX-listed stock suspensions, including the date a stock was suspended, the official reason, and a link to the IDX PDF notice. Filter by `symbol` to look up a specific company's suspension history, or by `start` / `end` to scope to a date window.
- [Broker Activity By Code](https://docs.sectors.app/api-references/v2/indonesia/brokers/broker-activity-by-code.md): IDX broker activity API: daily buy, sell and net value per stock for one Indonesian broker code over a date range.
- [Top Accumulations and Distributions Per Broker](https://docs.sectors.app/api-references/v2/indonesia/brokers/broker-activity-top.md): Returns the stocks a single broker has been most actively accumulating and distributing over a date range. `top_accumulations` ranks stocks the broker has net bought (largest positive net IDR first); `top_distributions` ranks stocks the broker has net sold (largest negative net IDR first). Each entr…
- [Broker Activity Per Symbol](https://docs.sectors.app/api-references/v2/indonesia/brokers/broker-summary-by-symbol.md): IDX broker summary API: buy and sell value and volume by broker for any Indonesian stock (IDX), including foreign vs domestic flow.
- [Top Buyers and Sellers Per Symbol](https://docs.sectors.app/api-references/v2/indonesia/brokers/broker-summary-top.md): Returns the brokers most actively accumulating and distributing a single IDX ticker over a date range. `top_buyers` ranks brokers by net buy value (largest positive net IDR first); `top_sellers` ranks brokers by net sell value (largest negative net IDR first). Each entry also reports how much of tha…
- [Broker Registry](https://docs.sectors.app/api-references/v2/indonesia/brokers/broker-registry.md): IDX broker code list API: every Indonesia Stock Exchange broker code with name, foreign or domestic origin, cohort and license type.
- [Top Brokers Daily Ranking](https://docs.sectors.app/api-references/v2/indonesia/brokers/top.md): Brokers ranked by gross trade value (default) or absolute net flow for a single date. Optionally filter by `origin` (foreign/domestic) and `cohort` (retail/mixed/institutional/unknown). Returns all matching brokers if `n_brokers` is omitted. Each row also reports the portion of the broker's turnover…
- [Daily Full-Universe Foreign Flow](https://docs.sectors.app/api-references/v2/indonesia/brokers/foreign-flow.md): Returns the net foreign-investor flow (IDR) of **every** IDX ticker on a single trading day, in one paginated feed — instead of calling the per-symbol [Daily Net Foreign Inflow](https://docs.sectors.app/api-references/v2/indonesia/brokers/foreign-flow-by-symbol) endpoint once per ticker. Sorted by `…
- [Daily Net Foreign Inflow](https://docs.sectors.app/api-references/v2/indonesia/brokers/foreign-flow-by-symbol.md): Daily net foreign-investor inflow (IDR) for one IDX ticker over a date range up to 90 days. Positive `net_foreign_inflow` means foreign investors were net buyers that day; negative means they were net sellers. `foreign_share` is the foreign fraction of the stock's two-sided turnover. Usually useful…
- [SGX Companies Screener](https://docs.sectors.app/api-references/v2/singapore/screener/sgx-companies.md): High-performance API for filtering and sorting SGX-listed companies. Supports both structured SQL-like queries (`where`, `order_by`) and natural language queries (`q`). Returns a paginated list of companies.
- [List all SGX sectors](https://docs.sectors.app/api-references/v2/singapore/helper-list/sgx-sectors.md): Returns all available SGX sector slugs as a flat array.
- [SGX Subsectors](https://docs.sectors.app/api-references/v2/singapore/helper-list/sgx-subsectors.md): Returns all available SGX sector/subsector pairs as kebab-case slugs. Use these values as inputs to `sector` and `sub_sector` parameters.
- [SGX News Tags](https://docs.sectors.app/api-references/v2/singapore/helper-list/sgx-tags.md): Returns the complete list of distinct tag slugs found across all SGX news articles. Use these values with the `tags` parameter of the [SGX News](https://docs.sectors.app/api-references/v2/singapore/news/sgx-news) endpoint.
- [SGX Corporate Actions](https://docs.sectors.app/api-references/v2/singapore/report/corporate-actions.md): <Note>SGX symbol: 3-4 characters (letters or digits), optionally followed by `.SI` (case-insensitive) on input. E.g. `D05`, `U11`, `Z74`. Output always carries the `.SI` suffix.</Note>
- [Full company report for an SGX-listed symbol](https://docs.sectors.app/api-references/v2/singapore/report/company-report.md): <Note>SGX symbol: 3-4 characters (letters or digits), optionally followed by `.SI` (case-insensitive) on input. E.g. `D05`, `U11`, `Z74`. Output always carries the `.SI` suffix.</Note>
- [SGX REIT Screener](https://docs.sectors.app/api-references/v2/singapore/reits/reits.md): Filter and sort SGX-listed REITs with a SQL-like `where` or a natural-language `q`. You get back the REITs that match; add `include_query_values=true` to also see the numbers each one was filtered and sorted on. To get REIT's full financials metrics, use [SGX REIT Performance](https://docs.sectors.a…
- [SGX REIT Performance](https://docs.sectors.app/api-references/v2/singapore/reits/reit-performance.md): One SGX REIT's results for a financial year: portfolio value and occupancy, revenue and net property income, distributions, debt (gearing, interest cover, cost of debt) and lease expiry.
- [SGX REIT Profile](https://docs.sectors.app/api-references/v2/singapore/reits/reit-profile.md): The basics on one SGX REIT: its name and sub-sector, who runs it (sponsor, trustee, REIT manager, property manager, and the master lessee or operator if it has one), and the board of directors of the REIT manager.
- [SGX REIT Properties](https://docs.sectors.app/api-references/v2/singapore/reits/reit-properties.md): Every property one SGX REIT reported for a financial year, from the highest valuation down. Properties that were sold or are up for sale stay in the list, marked in `status`.
- [SGX REIT Tenants](https://docs.sectors.app/api-references/v2/singapore/reits/reit-tenants.md): One SGX REIT's biggest tenants for a financial year, in rank order.
- [SGX REIT Trade Mix](https://docs.sectors.app/api-references/v2/singapore/reits/reit-trade-mix.md): How one SGX REIT's rental income splits by the kind of business its tenants run, such as Food & Beverages or Financial & Professional Services, for a financial year. Biggest share first.
- [SGX REIT Property Transactions](https://docs.sectors.app/api-references/v2/singapore/reits/reit-transactions.md): Completed property purchases and sales by SGX REITs, newest first. Filter by REIT, deal type, financial year or completion date.
- [SGX Share Buybacks](https://docs.sectors.app/api-references/v2/singapore/transaction/share-buybacks.md): Returns SGX share buyback records. Each row includes the purchase date, buyback type, price range, total value, total shares purchased, treasury shares after purchase, and mandate details.
- [SGX Daily Full-Universe Close](https://docs.sectors.app/api-references/v2/singapore/transaction/close.md): Returns the daily closing price for **every** SGX ticker on a single trading day, in one paginated feed — instead of calling the per-symbol [SGX Daily Price Data](https://docs.sectors.app/api-references/v2/singapore/transaction/daily) endpoint once per ticker.
- [SGX Daily Price Data](https://docs.sectors.app/api-references/v2/singapore/transaction/daily.md): SGX stock price API: daily close price and volume for Singapore stocks (SGX).
- [SGX Short Sell](https://docs.sectors.app/api-references/v2/singapore/transaction/short-sell.md): Returns SGX short sell data. Supports filtering by symbol and date range, and sorting via `order_by` (e.g. `start=2025-05-02&end=2025-05-02&order_by=-value` lists the most shorted stocks that day).
- [Top SGX companies by classification](https://docs.sectors.app/api-references/v2/singapore/ranking/top-companies.md): Returns top SGX-listed companies ranked by one or more classifications.
- [SGX Insider Filings](https://docs.sectors.app/api-references/v2/singapore/news/sgx-filings.md): Returns SGX insider trading filings — buy/sell transactions by company insiders and major shareholders. Supports filtering by symbol, transaction type, holder type, and date range.
- [SGX News](https://docs.sectors.app/api-references/v2/singapore/news/sgx-news.md): Returns paginated SGX news articles. Supports filtering by sector, sub-sector, tags, symbols, and date range.
- [List KLSE companies filtered by sector](https://docs.sectors.app/api-references/v2/malaysia/klse-companies.md): Returns all KLSE-listed companies in a given sector as `symbol` + `company_name` pairs.
- [Top KLSE companies by classification](https://docs.sectors.app/api-references/v2/malaysia/klse-top-companies.md): Returns top KLSE-listed companies ranked by one or more classifications.
- [Full company report for a KLSE-listed symbol](https://docs.sectors.app/api-references/v2/malaysia/klse-report.md): <Note>KLSE symbol: 4-digit numeric code. E.g. `1155`, `4197`, `5225`.</Note>
- [List all KLSE sectors](https://docs.sectors.app/api-references/v2/malaysia/klse-sectors.md): Returns all available KLSE sector slugs as a flat array.
- [List Mining Companies](https://docs.sectors.app/api-references/v2/mining/companies/mining-companies.md): Searches for Indonesian mining companies by name, symbol, slug, or key operation. Supports filtering by commodity type and company type.
- [Mining Company Detail](https://docs.sectors.app/api-references/v2/mining/companies/mining-companies-detail.md): Returns comprehensive operational details for a single mining company including activities, commodity types, licenses, contracts, and site count.
- [Mining Company Financials](https://docs.sectors.app/api-references/v2/mining/companies/mining-companies-financials.md): Returns annual financial records (assets, revenue, profit with breakdowns) for a mining company. All monetary values are in USD millions. Defaults to the latest available year.
- [Mining Company Ownership](https://docs.sectors.app/api-references/v2/mining/companies/mining-companies-ownership.md): Returns the corporate ownership tree for a mining company — showing parent companies (who owns it) and subsidiaries (what it owns) with percentage stakes.
- [Mining Company Performance](https://docs.sectors.app/api-references/v2/mining/companies/mining-companies-performance.md): Returns production volume, sales volume, strip ratio, and resources/reserves data for a mining company for a given year. Defaults to the latest available year.
- [List Commodities](https://docs.sectors.app/api-references/v2/mining/commodities-trade/commodities.md): Lists all commodities available in the price database with coverage metadata. Use this as a discovery endpoint before querying [Commodity Price History](https://docs.sectors.app/api-references/v2/mining/commodities-trade/commodity-price) endpoint.
- [Commodity Price History](https://docs.sectors.app/api-references/v2/mining/commodities-trade/commodity-price.md): Retrieves historical price data for a commodity by year range. Data is monthly (bi-weekly for recent Coal entries). Maximum range: 3 years.
- [Top Export Destinations](https://docs.sectors.app/api-references/v2/mining/commodities-trade/export-destination.md): Ranks countries by total export value for a given year and commodity, showing the top destinations for Indonesian commodity exports.
- [Global Commodity Data](https://docs.sectors.app/api-references/v2/mining/commodities-trade/global-commodity.md): Retrieves global commodity data including production, reserves, and trade information. At least one of `commodity_type` or `country` must be provided.
- [Company Sales Destinations](https://docs.sectors.app/api-references/v2/mining/commodities-trade/sales-destination.md): Retrieves sales destination breakdown for a specific mining company by its slug, showing revenue and volume distribution by country for a specific year. Defaults to the latest available year if none is specified.
- [Resources & Reserves Index](https://docs.sectors.app/api-references/v2/mining/sites-production/commodity-resources-reserves.md): Discovery index showing which provinces, years, and commodities have resources and reserves data available. Use this before querying the detail endpoint to confirm data availability.
- [Resources & Reserves Detail](https://docs.sectors.app/api-references/v2/mining/sites-production/commodity-resources-reserves-detail.md): Returns resources and reserves data for a single province, nested by year then by commodity. Each commodity entry contains the full breakdown: `exploration_target`, `total_inventory`, `resources`, `reserves`, and `unit`.
- [Mining Sites](https://docs.sectors.app/api-references/v2/mining/sites-production/mining-sites.md): Lists mining sites with advanced filtering for location, commodity type, and production volume, plus sorting capabilities and detailed site information.
- [Mining Site Detail](https://docs.sectors.app/api-references/v2/mining/sites-production/mining-site-detail.md): Returns full details for a single mining site by its slug, including parsed resources/reserves and location (with latitude and longitude).
- [Total Commodity Production](https://docs.sectors.app/api-references/v2/mining/sites-production/commodity-production.md): Returns total national production for a commodity across all years, including year-over-year percentage change. Results are ordered by year descending.
- [Mining Contracts](https://docs.sectors.app/api-references/v2/mining/licenses-auctions/mining-contracts.md): Returns active mining contracts linking mine owners to their service contractors. Optionally filter by owner or contractor slug.
- [Mining License Auctions](https://docs.sectors.app/api-references/v2/mining/licenses-auctions/mining-license-auctions.md): Lists mining license auctions scraped from the ESDM Minerba portal. Phases and participants are omitted from list results — use the detail endpoint for the full auction record.
- [Mining License Auction Detail](https://docs.sectors.app/api-references/v2/mining/licenses-auctions/mining-license-auctions-detail.md): Retrieves the full record for a single mining license auction by its WIUP code, including the parsed phases timeline and participant qualification list.
- [Mining Licenses](https://docs.sectors.app/api-references/v2/mining/licenses-auctions/mining-licenses.md): Lists mining licenses (IUP/IUPK) from the ESDM Minerba portal with filters for status, commodity, location, and expiry date.
- [v2 Changelog](https://docs.sectors.app/api-references/v2/changelog.md)
- [Recipes](https://docs.sectors.app/recipes/index.md): Practical guides and examples for building with the Sectors Financial API
- [Your First Sectors API Request in Python](https://docs.sectors.app/recipes/quick-start-in-python/00-your-first-request.md): Get an API key and call the Sectors Financial API from Python to fetch Indonesian stock data (IDX) in under 5 minutes.
- [List of All Subsectors](https://docs.sectors.app/recipes/quick-start-in-python/01-list-all-subsectors.md): List every Indonesian stock market (IDX) subsector with one Sectors Financial API call in Python, then load it into pandas.
- [Company Revenue Analysis by Subsectors](https://docs.sectors.app/recipes/quick-start-in-python/02-company-revenue-by-subsector-analysis.md): Compare revenue of Indonesian companies (IDX) within a subsector using the Sectors Financial API, pandas and Altair in Python.
- [Simple Moving Average on IDX Stocks](https://docs.sectors.app/recipes/quick-start-in-python/03-simple-moving-average.md): Calculate simple moving averages on daily Indonesian stock prices (IDX) from the Sectors Financial API with Python and pandas.
- [Analyzing Stock Price Changes: The Impact of Starlink's Arrival in Indonesia](https://docs.sectors.app/recipes/quick-start-in-python/04-stock-price-changes.md): Measure how Indonesian stock prices (IDX) moved around Starlink's arrival in Indonesia using daily data from the Sectors Financial API in Python.
- [Basic Exploratory Data Analysis and Simple Machine Learning Prediction for Stock Price](https://docs.sectors.app/recipes/quick-start-in-python/05-EDA-stock-price.md): Explore Indonesian stock price data (IDX) from the Sectors Financial API and fit a simple machine learning price prediction in Python.
- [Sectors MCP Server: IDX, SGX & KLSE Stock Data for AI Agents](https://docs.sectors.app/recipes/sectors-for-ai-agents/00-sectors-mcp-guide.md): Connect Claude, ChatGPT, Cursor or any MCP client to live Indonesian (IDX), Singapore (SGX) and Malaysian (KLSE) stock data. Setup, tools list and example prompts.
- [Sectors Agent Skill for Claude Code & AI Agents](https://docs.sectors.app/recipes/sectors-for-ai-agents/01-agent-skills-guide.md): Install the Sectors agent skill so coding agents call the Sectors Financial API for Indonesian (IDX) and Singapore (SGX) stock data correctly.
- [Connect Sectors to Claude (MCP + OAuth)](https://docs.sectors.app/recipes/sectors-for-ai-agents/02-sectors-in-claude.md): Add Sectors as a custom connector in Claude.ai or Claude Desktop with OAuth to analyze Indonesian (IDX), Singapore (SGX) and Malaysian (KLSE) stocks.
- [Connect Sectors to ChatGPT (MCP + OAuth)](https://docs.sectors.app/recipes/sectors-for-ai-agents/03-sectors-in-chatgpt.md): Add the Sectors MCP server to ChatGPT with OAuth and analyze Indonesian (IDX) and Singapore (SGX) stock data in chat.
- [Building a Human-Agent Collaboration Framework for IDX Stock Analysis](https://docs.sectors.app/recipes/sectors-for-ai-agents/04-human-agent.md): Build a human-agent collaboration framework for Indonesian stock analysis (IDX), inspired by FinArena, using the Sectors Financial API.
- [Stock Portfolio Optimization with Python](https://docs.sectors.app/recipes/stock-investing-and-finance/01-portfolio-optimization.md): Select Indonesian stocks (IDX) and optimise a portfolio with two models in Python using data from the Sectors Financial API.
- [How to Benchmark IDX Banking Stocks Using Python and the Sectors API ](https://docs.sectors.app/recipes/stock-investing-and-finance/02-benchmarking-idx-banking-stocks-sectors-api.md): Benchmark Indonesian banking stocks (IDX) like BBCA, BMRI and BNGA on quarterly profitability and efficiency with Python and the Sectors API.
- [Commodity-to-Equity: How Sensitive Are IDX Mining Stocks to Commodity Prices?](https://docs.sectors.app/recipes/stock-investing-and-finance/03-commodity-to-equity.md): Measure how Indonesian mining stocks (IDX) react to coal, nickel and gold prices using the Sectors Financial API and Python.
- [Import Stock API Data into Excel with Power Query](https://docs.sectors.app/recipes/non-programmatical-tools/01-excel/01-excel.md): Load Indonesian stock data (IDX) from the Sectors Financial API into Microsoft Excel with Power Query, no code required.
- [Import Stock API Data into Google Sheets (API Connector & Apps Script)](https://docs.sectors.app/recipes/non-programmatical-tools/02-sheets/02-sheets.md): Pull Indonesian stock data (IDX) from the Sectors Financial API into Google Sheets with an API connector extension or Apps Script.
- [Building Financial Dashboard in Looker Studio](https://docs.sectors.app/recipes/non-programmatical-tools/03-looker/03-looker.md): Build a financial dashboard in Looker Studio with Indonesian stock data (IDX) from the Sectors Financial API.
- [IDX Market Overview Data Integration and API Connections in Looker Studio](https://docs.sectors.app/recipes/non-programmatical-tools/03-looker/04-looker-bi-workshop.md): Build an Indonesian market (IDX / IHSG) overview dashboard in Looker Studio by connecting the Sectors Financial API.
- [Sectors API in n8n: Automate Stock Data Workflows](https://docs.sectors.app/recipes/non-programmatical-tools/04-n8n/01-n8n-sectors-api-guide.md): Connect the Sectors Financial API to n8n with the HTTP Request node and automate Indonesian stock data (IDX) workflows without code.
- [Building an AI-Powered Stock Analyst with Sectors API and n8n](https://docs.sectors.app/recipes/non-programmatical-tools/04-n8n/02-n8n-natural-language-screener.md): Build an AI stock analyst in n8n that runs natural-language screener queries on the Sectors API and explains each Indonesian stock (IDX) it returns.
- [Part 1: Setup, Data, and Model](https://docs.sectors.app/recipes/gnn-anomaly-detection/01-gnn-part-1.md): Fetch Indonesian stock data (IDX) from the Sectors API, build a return correlation graph and define a Graph Variational Autoencoder in Python.
- [Part 2: Training, Scoring, and Clustering](https://docs.sectors.app/recipes/gnn-anomaly-detection/02-gnn-part-2.md): Train a Graph Variational Autoencoder on Indonesian stocks (IDX), score anomalies from reconstruction error and cluster the results.
- [Part 3: Confirmation with Broker and Foreign Flow](https://docs.sectors.app/recipes/gnn-anomaly-detection/03-gnn-part-3.md): Confirm GNN stock anomaly scores with broker flow and foreign flow from the Sectors API, then combine them into one risk score per IDX stock.
- [SectorScan Part 1: Financial Data Visualization](https://docs.sectors.app/recipes/build-python-app/sectorscan/01-sectorscan-part1.md): Compare Indonesian (IDX) sectors by market cap, valuation and top companies with Python charts built on the Sectors Financial API.
- [SectorScan Part 2: Building a Financial Intelligence App w/ Streamlit](https://docs.sectors.app/recipes/build-python-app/sectorscan/02-sectorscan-part2.md): Turn the SectorScan charts into an interactive Streamlit app for comparing Indonesian (IDX) sectors with the Sectors Financial API.
- [Visualizing Barito Renewables (BREN) ascension to the top of IDX](https://docs.sectors.app/recipes/animated-plots-in-r/00-telling-stories-w-ggplot.md): Plot Barito Renewables (BREN) rising to the top of Indonesian stocks (IDX) by market cap with ggplot2, httr and the Sectors Financial API in R.
- [Most Traded Stocks on Indonesia Stock Exchange in 2024](https://docs.sectors.app/recipes/animated-plots-in-r/01-top-stock-volume-animation-plot.md): Build an animated bar chart race of the most traded Indonesian stocks (IDX) in 2024 with R, gganimate and the Sectors Financial API.
- [Stocks with Highest Market Capitalization since December 2020 on Indonesia Stock Exchange](https://docs.sectors.app/recipes/animated-plots-in-r/02-top-market-cap-animation-plot.md): Animate the largest Indonesian stocks (IDX) by market capitalization since December 2020 with R, gganimate and the Sectors Financial API.
- [Value Investing Strategy ](https://docs.sectors.app/recipes/animated-plots-in-r/03-financial-comparison-animation-plot.md): Compare Indonesian stocks (IDX) for value investing with an animated scatter plot built in R with gganimate and the Sectors Financial API.
- [Dividend Growth Investing Strategy](https://docs.sectors.app/recipes/animated-plots-in-r/04-dividend-growth-investing.md): Track dividend growth of Indonesian stocks (IDX) with an animated line chart built in R with gganimate and the Sectors Financial API.
- [Sectors Financial API Postman Collection](https://docs.sectors.app/recipes/postman-collection/01-postman-collection.md)
- [Best Practices for Safely Using the Sectors Financial API](https://docs.sectors.app/recipes/api-security/01-securing-api-usage.md): Use the Sectors Financial API safely: isolate environments, keep API keys in config files out of your code, manage dependencies and call over HTTPS.
- [IDX Broker Summary API: Broker Activity and Foreign Flow](https://docs.sectors.app/broker-summary-api.md): Broker summary API for Indonesian stocks (IDX): daily buy and sell value per broker code, top buyers and sellers, foreign vs domestic flow and the full broker code list.
- [Generative AI in Python](https://docs.sectors.app/recipes/generative-ai-python/index.md): Build LLM-powered financial agents on top of the Sectors Financial API
- [Generative AI for Finance](https://docs.sectors.app/recipes/generative-ai-python/01-background.md): An introduction to generative AI and LLMs for finance, and how retrieval-augmented generation (RAG) works with financial APIs like Sectors.
- [Tool Use and Function Calling for Finance LLMs](https://docs.sectors.app/recipes/generative-ai-python/02-tool-use.md): Tool use and function calling for finance LLMs: let an AI model call the Sectors API to answer stock questions, with Python examples.
- [Building Multi-Agent Workflows for Financial Research](https://docs.sectors.app/recipes/generative-ai-python/03-multiagent-workflows.md): Build multi-agent workflows in Python where specialised LLM agents call the Sectors Financial API to research Indonesian stocks (IDX).
- [Structured Output with Tool Use LLMs](https://docs.sectors.app/recipes/generative-ai-python/04-structured-output.md): Get structured, typed output from tool-use LLMs with LangChain while querying Indonesian stock data (IDX) from the Sectors Financial API.
- [Tool-Use ReAct Conversational Agents](https://docs.sectors.app/recipes/generative-ai-python/05-conversational.md): Build a ReAct conversational agent in Python with LangChain that calls the Sectors Financial API to answer questions about Indonesian stocks (IDX).
- [Conversational Memory and Tool Use AI Agents](https://docs.sectors.app/recipes/generative-ai-python/06-memory-ai.md): Add conversational memory to a tool-use AI agent with LangChain so follow-up questions about Indonesian stocks (IDX) keep their context.

## OpenAPI Specs

- [schema](/schema.json)

## Optional

- [Community](https://discord.com/invite/TAnZMmNS4X)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.