SEsectors
Rankings

Top Company Movers

Returns top gainers and losers across multiple time periods. Supports two classifications (top_gainers, top_losers) and five periods (1d, 7d, 14d, 30d, 365d).

<Info>Costs 1 API credit per requested classification × period combination. Default behavior (2 classifications × 5 periods) consumes 10 credits.</Info>

get/v2/companies/top-changes/

Request

  • Base URL
    https://api.sectors.app
  • URL
    https://api.sectors.app/v2/companies/top-changes/
  • Auth
    API key in header Authorization

Query parameters

sub_sectorstring

Filter by kebab-case subsector slug. E.g. banks. Get valid values from the Subsectors endpoint.

n_stockinteger

Number of companies per period. Default 5, max 10.

classificationsstring[]

Comma-separated. Choices: top_gainers, top_losers. Default: both.

periodsstring[]

Comma-separated periods. Choices: 1d, 7d, 14d, 30d, 365d. Default: all.

min_mcap_billioninteger

Minimum market cap filter in billion IDR. Default 5000.

Response

Top gainers and losers grouped by period. Only requested classifications/periods appear in the response.

top_gainersobject required

Keyed by period (1d, 7d, 14d, 30d, 365d).

top_losersobject required

Keyed by period (1d, 7d, 14d, 30d, 365d).

Changes

No recorded changes to this operation across all 2 revisions of this API.