# Sectors Financial API

## Docs

- [v2 Changelog](https://docs.sectors.app/api-references/v2/changelog.md)
- [Companies Screener](https://docs.sectors.app/api-references/v2/indonesia/companies.md): High-performance API for filtering and sorting IDX-listed companies. Supports both structured SQL-like queries (`where`, `order_by`) and natural language queries (`q`). Returns a paginated list of companies.
- [Free Float Market Analysis](https://docs.sectors.app/api-references/v2/indonesia/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.
- [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 ticker, 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.
- [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 ticker, across 7, 30, 90, and 365-day windows.
- [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, 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.
- [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.
- [Top Company Movers](https://docs.sectors.app/api-references/v2/indonesia/ranking/top-changes.md): Returns top gainers and losers across multiple time periods. Each classification (top_gainers / top_losers) and each period (1d, 7d, 14d, 30d, 365d) consumes one API call.
- [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.
- [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](../helper-list/companies-segments-list) endpoint to check availability.
- [Company Quarterly Financials](https://docs.sectors.app/api-references/v2/indonesia/report/quarterly-financials.md): Returns quarterly financial data for a given IDX ticker. 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 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 ticker 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.
- [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.
- [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.
- [Full company report for a KLSE-listed ticker](https://docs.sectors.app/api-references/v2/malaysia/klse-report.md): <Note>KLSE ticker: 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.
- [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. Each classification requested consumes one API credit.
- [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](../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.
- [Mining Contracts](https://docs.sectors.app/api-references/v2/mining/commodities-trade/mining-contracts.md): Returns active mining contracts linking mine owners to their service contractors. Optionally filter by owner or contractor slug.
- [List Mining Companies](https://docs.sectors.app/api-references/v2/mining/companies/mining-companies.md): Searches for Indonesian mining companies by name, ticker, 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.
- [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.
- [Company Sales Destinations](https://docs.sectors.app/api-references/v2/mining/sales/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.
- [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.
- [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.
- [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.
- [List SGX companies filtered by sector](https://docs.sectors.app/api-references/v2/singapore/sgx-companies.md): Returns all SGX-listed companies in a given sector as `symbol` + `company_name` pairs.
- [Full company report for an SGX-listed ticker](https://docs.sectors.app/api-references/v2/singapore/sgx-report.md): <Note>SGX ticker: 3 characters (letters or digits), optionally followed by `.si` (case-insensitive). E.g. `D05`, `U11`, `Z74`.</Note>
- [List all SGX sectors](https://docs.sectors.app/api-references/v2/singapore/sgx-sectors.md): Returns all available SGX sector slugs as a flat array.
- [Top SGX companies by classification](https://docs.sectors.app/api-references/v2/singapore/sgx-top-companies.md): Returns top SGX-listed companies ranked by one or more classifications. Each classification requested consumes one API credit.
- [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
- [Sectors Financial API](https://docs.sectors.app/get-started/v2/overview.md): Indonesia's financial data platform, now with API access ✨
- [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): By: [Samuel Chan](https://github.com/onlyphantom) · May 18, 2024
- [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): By: [Gerald Bryan](https://github.com/geraldbryan) · April 23, 2024
- [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): By: [Gerald Bryan](https://github.com/geraldbryan) · April 25, 2024
- [Value Investing Strategy ](https://docs.sectors.app/recipes/animated-plots-in-r/03-financial-comparison-animation-plot.md): By: [Gerald Bryan](https://github.com/geraldbryan) · May 2, 2024
- [Dividend Growth Investing Strategy](https://docs.sectors.app/recipes/animated-plots-in-r/04-dividend-growth-investing.md): By: [Gerald Bryan](https://github.com/geraldbryan) · May 16, 2024
- [Best Practices for Safely Using the Sectors Financial API](https://docs.sectors.app/recipes/api-security/01-securing-api-usage.md): By: [Gladbert Sogo](https://github.com/Gladbert) · February 20, 2025
- [SectorScan Part 1: Financial Data Visualization](https://docs.sectors.app/recipes/build-python-app/sectorscan/01-sectorscan-part1.md): By: [Aurellia Christie](https://www.github.com/AurelliaChristie) · May 30, 2024
- [SectorScan Part 2: Building a Financial Intelligence App w/ Streamlit](https://docs.sectors.app/recipes/build-python-app/sectorscan/02-sectorscan-part2.md): By: [Aurellia Christie](https://www.github.com/AurelliaChristie) · May 30, 2024
- [Generative AI for Finance](https://docs.sectors.app/recipes/generative-ai-python/01-background.md): By: [Samuel Chan](https://www.github.com/onlyphantom) · August 1, 2024
- [Tool Use and Function Calling for Finance LLMs](https://docs.sectors.app/recipes/generative-ai-python/02-tool-use.md): By: [Samuel Chan](https://www.github.com/onlyphantom) · August 1, 2024
- [Building Multi-Agent Workflows for Financial Research](https://docs.sectors.app/recipes/generative-ai-python/03-multiagent-workflows.md): By: [Billy Samuel](https://github.com/billysams21), [Andreas Christianto](https://github.com/AndreChristianto) · March 5, 2026
- [Structured Output with Tool Use LLMs](https://docs.sectors.app/recipes/generative-ai-python/04-structured-output.md): By: [Samuel Chan](https://www.github.com/onlyphantom) · October 1, 2024
- [Tool-Use ReAct Conversational Agents](https://docs.sectors.app/recipes/generative-ai-python/05-conversational.md): By: [Samuel Chan](https://www.github.com/onlyphantom) · October 10, 2024
- [Conversational Memory and Tool Use AI Agents](https://docs.sectors.app/recipes/generative-ai-python/06-memory-ai.md): By: [Samuel Chan](https://www.github.com/onlyphantom) · October 16, 2024
- [Microsoft Excel Power Query](https://docs.sectors.app/recipes/non-programmatical-tools/01-excel/01-excel.md): By: [Vincentius C. Calvin](https://www.github.com/vccalvin33) · July 13, 2024
- [Using Data from API on Google Sheets](https://docs.sectors.app/recipes/non-programmatical-tools/02-sheets/02-sheets.md): By: [Vincentius C. Calvin](https://www.github.com/vccalvin33) · July 19, 2024
- [Building Financial Dashboard in Looker Studio](https://docs.sectors.app/recipes/non-programmatical-tools/03-looker/03-looker.md): By: [Aurellia Christie](https://www.github.com/AurelliaChristie) · October 23, 2024
- [IDX Market Overview Dashboard Part 1: Data Integration and API Connections](https://docs.sectors.app/recipes/non-programmatical-tools/03-looker/04-looker-bi-workshop.md): By: [Gerald Bryan](https://www.github.com/geraldbryan) · December 13, 2024
- [Using the Sectors API with n8n](https://docs.sectors.app/recipes/non-programmatical-tools/04-n8n/01-n8n-sectors-api-guide.md): By: [Andreas Christianto](https://www.github.com/AndreChristianto) · March 16, 2026
- [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): By: [Andreas Christianto](https://www.github.com/AndreChristianto) · March 16, 2026
- [Sectors Financial API Postman Collection](https://docs.sectors.app/recipes/postman-collection/01-postman-collection.md)
- [Your First Request!](https://docs.sectors.app/recipes/quick-start-in-python/00-your-first-request.md)
- [List of All Subsectors](https://docs.sectors.app/recipes/quick-start-in-python/01-list-all-subsectors.md): By: [Aidityas Adhakim](https://www.github.com/aidityasadhakim) · April 16, 2024
- [Company Revenue Analysis by Subsectors](https://docs.sectors.app/recipes/quick-start-in-python/02-company-revenue-by-subsector-analysis.md): By: [Aidityas Adhakim](https://www.github.com/aidityasadhakim) · April 23, 2024
- [Simple Moving Average on IDX Stocks](https://docs.sectors.app/recipes/quick-start-in-python/03-simple-moving-average.md): By: [Aidityas Adhakim](https://www.github.com/aidityasadhakim) · April 16, 2024
- [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): By: [Gerald Bryan](https://github.com/geraldbryan) · May 29, 2024
- [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): By: [Jeremya Dharmawan](https://github.com/jejejery) · Nov 01, 2024
- [Use Sectors MCP Server for Financial Analysis](https://docs.sectors.app/recipes/sectors-for-ai-agents/00-sectors-mcp-guide.md)
- [Sectors Financial API Agent Skill - User Guide](https://docs.sectors.app/recipes/sectors-for-ai-agents/01-agent-skills-guide.md)
- [Stock Portfolio Optimization with Python](https://docs.sectors.app/recipes/stock-investing-and-finance/01 - Portfolio-Optimization.md): By: [Rian Yan](https://github.com/rianyan9723) · October 10, 2024

## OpenAPI Specs

- [schema](https://docs.sectors.app/schema.json)
- [Supertype_API_02-2025_v1.1.postman_collection](https://docs.sectors.app/recipes/postman-collection/json/Supertype_API_02-2025_v1.1.postman_collection.json)

## Optional

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