Get Started
API References
- Indonesia
- Helper List
- Since IPO Performance
- Detailed Reports
- Company Ranking by Dimensions
- Historical Market Cap & Transaction Data
- Singapore
- Malaysia
Top Companies Ranked
Return a list of top tickers in a given year based on certain classification (dividend yield, total dividend, revenue, earnings, market cap, PB ratio, PE ratio, or PS ratio)
curl --request GET \
--url https://api.sectors.app/v1/companies/top/ \
--header 'Authorization: <authorization>'
{
"dividend_yield": [
{
"symbol": "BSSR.JK",
"company_name": "Baramulti Suksessarana Tbk",
"dividend_yield": 0.0378406861249138
},
{
"symbol": "TOWR.JK",
"company_name": "Sarana Menara Nusantara Tbk",
"dividend_yield": 0.0115384615384615
}
],
"total_dividend": [
{
"symbol": "BSSR.JK",
"company_name": "Baramulti Suksessarana Tbk",
"total_dividend": 154.39
},
{
"symbol": "TOWR.JK",
"company_name": "Sarana Menara Nusantara Tbk",
"total_dividend": 6
}
],
"revenue": [],
"earnings": [],
"market_cap": [
{
"symbol": "BBCA.JK",
"company_name": "PT Bank Central Asia Tbk.",
"market_cap": 973872492969984
},
{
"symbol": "BREN.JK",
"company_name": "PT Barito Renewables Energy Tbk.",
"market_cap": 799371327176704
},
{
"symbol": "BYAN.JK",
"company_name": "Bayan Resources Tbk",
"market_cap": 666665964535808
},
{
"symbol": "TPIA.JK",
"company_name": "PT Chandra Asri Pacific Tbk",
"market_cap": 627208368422912
},
{
"symbol": "BBRI.JK",
"company_name": "PT Bank Rakyat Indonesia (Persero) Tbk",
"market_cap": 557401291882496
}
],
"pb": [
{
"symbol": "LPKR.JK",
"company_name": "Lippo Karawaci Tbk",
"pb": 0.19727005553874
},
{
"symbol": "INKP.JK",
"company_name": "Indah Kiat Pulp & Paper Tbk",
"pb": 0.283874962483822
},
{
"symbol": "GGRM.JK",
"company_name": "Gudang Garam Tbk",
"pb": 0.318841313815744
},
{
"symbol": "SIMP.JK",
"company_name": "Salim Ivomas Pratama Tbk",
"pb": 0.319556704820058
},
{
"symbol": "PNLF.JK",
"company_name": "Panin Financial Tbk",
"pb": 0.334066430099396
}
],
"pe": [
{
"symbol": "LPKR.JK",
"company_name": "Lippo Karawaci Tbk",
"pe": 0.329687323085414
},
{
"symbol": "PNLF.JK",
"company_name": "Panin Financial Tbk",
"pe": 2.06785933170332
},
{
"symbol": "ADRO.JK",
"company_name": "Alamtri Resources Indonesia Tbk",
"pe": 2.39392429475712
},
{
"symbol": "AADI.JK",
"company_name": "PT Adaro Andalan Indonesia Tbk",
"pe": 2.71665379882592
},
{
"symbol": "SMRA.JK",
"company_name": "PT Summarecon Agung Tbk",
"pe": 3.56657984352755
}
],
"ps": [
{
"symbol": "ERAA.JK",
"company_name": "Erajaya Swasembada Tbk",
"ps": 0.0900122165601871
},
{
"symbol": "SMAR.JK",
"company_name": "PT Sinar Mas Agro Resources and Technology Tbk",
"ps": 0.125328568130454
},
{
"symbol": "INDY.JK",
"company_name": "Indika Energy Tbk",
"ps": 0.171830180155131
},
{
"symbol": "GGRM.JK",
"company_name": "Gudang Garam Tbk",
"ps": 0.177518548993861
},
{
"symbol": "EPMT.JK",
"company_name": "Enseval Putera Megatrading Tbk",
"ps": 0.183440161556531
}
]
}
{
"dividend_yield": [
{
"symbol": "BSSR.JK",
"company_name": "Baramulti Suksessarana Tbk",
"dividend_yield": 0.0378406861249138
},
{
"symbol": "TOWR.JK",
"company_name": "Sarana Menara Nusantara Tbk",
"dividend_yield": 0.0115384615384615
}
],
"total_dividend": [
{
"symbol": "BSSR.JK",
"company_name": "Baramulti Suksessarana Tbk",
"total_dividend": 154.39
},
{
"symbol": "TOWR.JK",
"company_name": "Sarana Menara Nusantara Tbk",
"total_dividend": 6
}
],
"revenue": [],
"earnings": [],
"market_cap": [
{
"symbol": "BBCA.JK",
"company_name": "PT Bank Central Asia Tbk.",
"market_cap": 973872492969984
},
{
"symbol": "BREN.JK",
"company_name": "PT Barito Renewables Energy Tbk.",
"market_cap": 799371327176704
},
{
"symbol": "BYAN.JK",
"company_name": "Bayan Resources Tbk",
"market_cap": 666665964535808
},
{
"symbol": "TPIA.JK",
"company_name": "PT Chandra Asri Pacific Tbk",
"market_cap": 627208368422912
},
{
"symbol": "BBRI.JK",
"company_name": "PT Bank Rakyat Indonesia (Persero) Tbk",
"market_cap": 557401291882496
}
],
"pb": [
{
"symbol": "LPKR.JK",
"company_name": "Lippo Karawaci Tbk",
"pb": 0.19727005553874
},
{
"symbol": "INKP.JK",
"company_name": "Indah Kiat Pulp & Paper Tbk",
"pb": 0.283874962483822
},
{
"symbol": "GGRM.JK",
"company_name": "Gudang Garam Tbk",
"pb": 0.318841313815744
},
{
"symbol": "SIMP.JK",
"company_name": "Salim Ivomas Pratama Tbk",
"pb": 0.319556704820058
},
{
"symbol": "PNLF.JK",
"company_name": "Panin Financial Tbk",
"pb": 0.334066430099396
}
],
"pe": [
{
"symbol": "LPKR.JK",
"company_name": "Lippo Karawaci Tbk",
"pe": 0.329687323085414
},
{
"symbol": "PNLF.JK",
"company_name": "Panin Financial Tbk",
"pe": 2.06785933170332
},
{
"symbol": "ADRO.JK",
"company_name": "Alamtri Resources Indonesia Tbk",
"pe": 2.39392429475712
},
{
"symbol": "AADI.JK",
"company_name": "PT Adaro Andalan Indonesia Tbk",
"pe": 2.71665379882592
},
{
"symbol": "SMRA.JK",
"company_name": "PT Summarecon Agung Tbk",
"pe": 3.56657984352755
}
],
"ps": [
{
"symbol": "ERAA.JK",
"company_name": "Erajaya Swasembada Tbk",
"ps": 0.0900122165601871
},
{
"symbol": "SMAR.JK",
"company_name": "PT Sinar Mas Agro Resources and Technology Tbk",
"ps": 0.125328568130454
},
{
"symbol": "INDY.JK",
"company_name": "Indika Energy Tbk",
"ps": 0.171830180155131
},
{
"symbol": "GGRM.JK",
"company_name": "Gudang Garam Tbk",
"ps": 0.177518548993861
},
{
"symbol": "EPMT.JK",
"company_name": "Enseval Putera Megatrading Tbk",
"ps": 0.183440161556531
}
]
}
Header
Authorization header that should be filled with your Sectors Financial API key.
Query Parameters
Classification(s) for ranking the top tickers in a given year (defaults to all). Use a comma to separate multiple classifications.
dividend_yield
, total_dividend
, revenue
, earnings
, market_cap
,
pb
, pe
, ps
Separate multiple classifications using commas.
Each classification queried consumes one API call.
Filter conditions to further narrow the results. Use a comma-separated list of filter expressions.
Example: pe > 20, revenue > 1000
, >=
, <=
, <
, >
=
Use the same targets as classifications (except for market_cap
which is represented by min_mcap_billion
).
Logical operator to combine multiple filters. This parameter is only
applicable if filters are provided. Accepts
or
and
(case insensitive).or
When multiple filters are provided, this parameter specifies whether all
conditions must be met (
) or if any condition can be met
(and
).or
Number of tickers to be retrieved (defaults to 5, with a maximum of 10).
Minimum market cap of the retrieved companies in billion IDR.
The sub-sector from which the top companies will be retrieved. The sub-sector should be provided in kebab-case.
Retrieve the available sub_sector
values from the
Subsectors
endpoint.
Examples include banks
, financing-service
, insurance
, retailing
,
tobacco
.
The API only accepts sub_sector values in lowercase kebab-case.
Year for which the list of top tickers is to be retrieved (default to the current year).
Response
curl --request GET \
--url https://api.sectors.app/v1/companies/top/ \
--header 'Authorization: <authorization>'
{
"dividend_yield": [
{
"symbol": "BSSR.JK",
"company_name": "Baramulti Suksessarana Tbk",
"dividend_yield": 0.0378406861249138
},
{
"symbol": "TOWR.JK",
"company_name": "Sarana Menara Nusantara Tbk",
"dividend_yield": 0.0115384615384615
}
],
"total_dividend": [
{
"symbol": "BSSR.JK",
"company_name": "Baramulti Suksessarana Tbk",
"total_dividend": 154.39
},
{
"symbol": "TOWR.JK",
"company_name": "Sarana Menara Nusantara Tbk",
"total_dividend": 6
}
],
"revenue": [],
"earnings": [],
"market_cap": [
{
"symbol": "BBCA.JK",
"company_name": "PT Bank Central Asia Tbk.",
"market_cap": 973872492969984
},
{
"symbol": "BREN.JK",
"company_name": "PT Barito Renewables Energy Tbk.",
"market_cap": 799371327176704
},
{
"symbol": "BYAN.JK",
"company_name": "Bayan Resources Tbk",
"market_cap": 666665964535808
},
{
"symbol": "TPIA.JK",
"company_name": "PT Chandra Asri Pacific Tbk",
"market_cap": 627208368422912
},
{
"symbol": "BBRI.JK",
"company_name": "PT Bank Rakyat Indonesia (Persero) Tbk",
"market_cap": 557401291882496
}
],
"pb": [
{
"symbol": "LPKR.JK",
"company_name": "Lippo Karawaci Tbk",
"pb": 0.19727005553874
},
{
"symbol": "INKP.JK",
"company_name": "Indah Kiat Pulp & Paper Tbk",
"pb": 0.283874962483822
},
{
"symbol": "GGRM.JK",
"company_name": "Gudang Garam Tbk",
"pb": 0.318841313815744
},
{
"symbol": "SIMP.JK",
"company_name": "Salim Ivomas Pratama Tbk",
"pb": 0.319556704820058
},
{
"symbol": "PNLF.JK",
"company_name": "Panin Financial Tbk",
"pb": 0.334066430099396
}
],
"pe": [
{
"symbol": "LPKR.JK",
"company_name": "Lippo Karawaci Tbk",
"pe": 0.329687323085414
},
{
"symbol": "PNLF.JK",
"company_name": "Panin Financial Tbk",
"pe": 2.06785933170332
},
{
"symbol": "ADRO.JK",
"company_name": "Alamtri Resources Indonesia Tbk",
"pe": 2.39392429475712
},
{
"symbol": "AADI.JK",
"company_name": "PT Adaro Andalan Indonesia Tbk",
"pe": 2.71665379882592
},
{
"symbol": "SMRA.JK",
"company_name": "PT Summarecon Agung Tbk",
"pe": 3.56657984352755
}
],
"ps": [
{
"symbol": "ERAA.JK",
"company_name": "Erajaya Swasembada Tbk",
"ps": 0.0900122165601871
},
{
"symbol": "SMAR.JK",
"company_name": "PT Sinar Mas Agro Resources and Technology Tbk",
"ps": 0.125328568130454
},
{
"symbol": "INDY.JK",
"company_name": "Indika Energy Tbk",
"ps": 0.171830180155131
},
{
"symbol": "GGRM.JK",
"company_name": "Gudang Garam Tbk",
"ps": 0.177518548993861
},
{
"symbol": "EPMT.JK",
"company_name": "Enseval Putera Megatrading Tbk",
"ps": 0.183440161556531
}
]
}