GET
/
companies
/
top
curl --request GET \
  --url https://api.sectors.app/v1/companies/top/ \
  --header 'Authorization: <authorization>'
{
  "dividend_yield": [
    {
      "symbol": "BJTM.JK",
      "company_name": "Bank Pembangunan Daerah Jawa Timur Tbk",
      "dividend_yield": 0.100722221091942
    }
  ],
  "total_dividend": [
    {
      "symbol": "ITMG.JK",
      "company_name": "Indo Tambangraya Megah Tbk",
      "total_dividend": 1747
    }
  ],
  "revenue": [
    {
      "symbol": "HEXA.JK",
      "company_name": "Hexindo Adiperkasa Tbk",
      "revenue": 9733050640014
    }
  ],
  "earnings": [
    {
      "symbol": "HEXA.JK",
      "company_name": "Hexindo Adiperkasa Tbk",
      "earnings": 885551723663
    }
  ],
  "market_cap": [
    {
      "symbol": "BREN.JK",
      "company_name": "Barito Renewables Energy Tbk",
      "market_cap": 1331170755215360
    }
  ],
  "pb": [
    {
      "symbol": "SIMP.JK",
      "company_name": "Salim Ivomas Pratama Tbk",
      "pb": 0.353609154167041
    }
  ], 
  "pe": [
    {
      "symbol": "ABMM.JK",
      "company_name": "ABM Investama Tbk",
      "pe": 3.34535382315737
    }
  ], 
  "ps": [
    {
      "symbol": "ERAA.JK",
      "company_name": "Erajaya Swasembada Tbk",
      "ps": 0.111830819088361
    }
  ]
}

{
  "dividend_yield": [
    {
      "symbol": "BJTM.JK",
      "company_name": "Bank Pembangunan Daerah Jawa Timur Tbk",
      "dividend_yield": 0.100722221091942
    }
  ],
  "total_dividend": [
    {
      "symbol": "ITMG.JK",
      "company_name": "Indo Tambangraya Megah Tbk",
      "total_dividend": 1747
    }
  ],
  "revenue": [
    {
      "symbol": "HEXA.JK",
      "company_name": "Hexindo Adiperkasa Tbk",
      "revenue": 9733050640014
    }
  ],
  "earnings": [
    {
      "symbol": "HEXA.JK",
      "company_name": "Hexindo Adiperkasa Tbk",
      "earnings": 885551723663
    }
  ],
  "market_cap": [
    {
      "symbol": "BREN.JK",
      "company_name": "Barito Renewables Energy Tbk",
      "market_cap": 1331170755215360
    }
  ],
  "pb": [
    {
      "symbol": "SIMP.JK",
      "company_name": "Salim Ivomas Pratama Tbk",
      "pb": 0.353609154167041
    }
  ], 
  "pe": [
    {
      "symbol": "ABMM.JK",
      "company_name": "ABM Investama Tbk",
      "pe": 3.34535382315737
    }
  ], 
  "ps": [
    {
      "symbol": "ERAA.JK",
      "company_name": "Erajaya Swasembada Tbk",
      "ps": 0.111830819088361
    }
  ]
}
​
Authorization
string
required

Authorization header that should be filled with your Sectors Financial API key.

​
Query Parameters

​
classifications
string
default:
"all"

Classification for ranking the top tickers in a given year (default to all).

​
n_stock
integer
default:
"5"

Number of tickers to be retrieved (defaults to 5, with a maximum of 10).

​
min_mcap_billion
integer
default:
"5000"

Minimum market cap of the retrieved companies in billion IDR.

​
sub_sector
string
default:
"all"

Subsector from which the list of top companies is to be retrieved.

​
year
integer
default:
"current year"

Year for which the list of top tickers is to be retrieved (default to the current year).

​
Response

​
dividend_yield
DividendYieldData[]
​
total_dividend
TotalDividendData[]
​
revenue
RevenueData[]
​
earnings
EarningsData[]
​
market_cap
MarketCapData[]
​
pb
PBData[]
​
pe
PEData[]
​
ps
PSData[]
Most Traded Stocks by VolumeTop Company Movers