Welcome to the Sectors Financial API documentation! This guide is designed to help developers and integrators get started with our API, which provides market and analytical data specific to Indonesia. Whether you’re building financial applications, conducting market research, or integrating data into your platform, this API will provide you with the tools you need.

In this tutorial, we’ll walk you through how to use our Postman Collection to explore and test our API endpoints.


Introduction

The Sectors Financial API offers a wide range of financial and analytical data for the Indonesian market. You can access real-time stock prices, historical data, market trends, and more. To make it easier for developers to interact with our API, we have created a Postman Collection that contains all the necessary endpoints and example requests.


Prerequisites

Before you begin, ensure you have the following:

  • Postman: Download and install Postman if you haven’t already.
  • API Key: You will need an API key to authenticate your requests. If you don’t have one, please go to Sectors Financial API to generate API key for your account.
  • Basic Knowledge of APIs: Familiarity with RESTful APIs and JSON formats is recommended.

Getting Started with Postman

Postman is a powerful tool for testing and interacting with APIs. It allows you to send HTTP requests, view responses, and organize your API calls into collections.

If you’re new to Postman, check out their official documentation to get familiar with the interface.


Importing the Sectors Financial API Postman Collection

To start using our API, follow these steps to import the Sectors Financial API Postman Collection:

  1. Download the Postman Collection:

    • Click here Postman Collection and download the latest version of the Postman collection file.
  2. Open Postman:

    • Launch the Postman application on your computer.
  3. Import the Collection:

    • Click on the Import button in the top-left corner of the Postman interface.
    • Select the downloaded Supertype_API_02-2025_v1.1.postman_collection.json file and click Open.
    • The collection will now appear in your Postman workspace under the Collections tab.

API Endpoints

Our API provides several endpoints to fetch different types of financial data. Here is the full API Reference for you to check the details

Collection Structure

The collection is organized into folders, each representing a specific functionality or endpoint group. Each folder contains one or more requests.

Folder Structure:

  • Helper List
    • GET Subsectors
    • GET Subindustries
    • GET Industries
    • GET Companies by Index
    • GET Companies by Subsector
    • GET Companies by Subindustry
    • GET Companies with Revenue and Cost Segments
    • GET Quarterly Financial Dates of a Company
  • Since IPO Performance
    • GET Company's Performance since IPO
  • Detailed Reports
    • GET Company Report
    • GET Company Revenue and Cost Segments
    • GET Company Quarterly Financials
    • GET Subsector Aggregated Statistics
  • Company Ranking by Dimensions
    • GET Most Traded Stocks by Volume
    • GET Top Companies Ranked
    • GET Top Company Movers
    • GET Top Companies by Growth Metrics
  • Historical Market Cap and Transaction Data
    • GET IDX Historical Market Cap Data
    • GET Daily Transaction Data
    • GET Index Daily Transaction Data
  • Singapore Stock Exchange (SGX)
    • GET SGX Sectors
    • GET SGX Companies by Sector
    • GET SGX Company Report
    • GET SGX Top Companies Ranked
  • Malaysia Stock Exchange (KLSE)
    • GET KLSE Sectors
    • GET KLSE Companies by Sector
    • GET KLSE Company Report
    • GET KLSE Top Companies Ranked

Each request is pre-configured with the necessary parameters and variables.

Using Variables

The collection uses variables to make it reusable and customizable. There are two types of variables:

  1. Collection Variables: These are shared across all requests in the collection. Examples include:

    • {{environment}}: The base URL for the API (default data: https://api.sectors.app).
    • {{apikey}}: Your API key (replace this with your own key).
    • {{ticker}}: The stock ticker symbol (e.g., AAPL).
  2. Request-Specific Variables: Some parameters are unique to specific requests and are defined within the request itself. For example:

    • {{report_date}}: The report date for financial data (e.g., 2023-09-30).