---
title: "Top Company Movers"
method: GET
path: "/v2/companies/top-changes/"
tags: ["Rankings"]
---

# Top Company Movers

`GET /v2/companies/top-changes/`

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>

## Query parameters

- `sub_sector` string
- `n_stock` integer
- `classifications` string[]
- `periods` string[]
- `min_mcap_billion` integer

## Response `200`

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

- TopCompaniesChangesResponse
  - `top_gainers` object, required — Keyed by period (`1d`, `7d`, `14d`, `30d`, `365d`).
  - `top_losers` object, required — Keyed by period (`1d`, `7d`, `14d`, `30d`, `365d`).

## 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)