---
title: "Top SGX companies by classification"
method: GET
path: "/v2/sgx/companies/top/"
tags: ["SGX - Rankings"]
---

# Top SGX companies by classification

`GET /v2/sgx/companies/top/`

Returns top SGX-listed companies ranked by one or more classifications.

<Accordion title="Available classifications">
`dividend_yield`, `revenue`, `earnings`, `market_cap`, `pe`
</Accordion>

<Note>Get valid sector slugs from the [SGX Sectors](../singapore/sgx-sectors) endpoint.</Note>

<Info>Costs 1 API credit per requested classification. Default behavior (all 5 classifications) consumes 5 credits.</Info>

## Query parameters

- `sector` string
- `n_stock` integer
- `classifications` string[]
- `min_mcap_million` integer

## Response `200`

Top companies per requested classification. Each top-level key is optional and present only if requested via the `classifications` parameter.

- SGXTopCompaniesResponse
  - `dividend_yield` SGXTopDividendYieldRow[]
    - `symbol` string, required — SGX 3-character symbol.
    - `company_name` string, required — Full company name.
    - `forward_dividend_yield` number, double, nullable, required — Forward dividend yield as a decimal.
  - `revenue` SGXTopRevenueRow[]
    - `symbol` string, required — SGX 3-character symbol.
    - `company_name` string, required — Full company name.
    - `revenue` integer, nullable, required — Total revenue (SGD).
  - `earnings` SGXTopEarningsRow[]
    - `symbol` string, required — SGX 3-character symbol.
    - `company_name` string, required — Full company name.
    - `earnings` integer, nullable, required — Total earnings (SGD).
  - `market_cap` SGXTopMarketCapRow[]
    - `symbol` string, required — SGX 3-character symbol.
    - `company_name` string, required — Full company name.
    - `market_cap` integer, nullable, required — Market capitalization (SGD).
  - `pe` SGXTopPeRow[]
    - `symbol` string, required — SGX 3-character symbol.
    - `company_name` string, required — Full company name.
    - `pe` number, double, nullable, required — Price-to-earnings ratio.

## Other responses

- `400` — Invalid parameters.
- `429` — Rate limit exceeded.

---

[API](https://skmtc.dev/sectors/apis/sectors-api.md) · [All operations](https://skmtc.dev/sectors/apis/sectors-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sectors/sectors-api/revisions/49e492f19d77/schema)