---
title: "Free Float Market Analysis"
method: GET
path: "/v2/free-float/"
tags: ["Company Screener"]
---

# Free Float Market Analysis

`GET /v2/free-float/`

Returns the free float percentage for IDX-listed companies, optionally filtered by one level of the sector taxonomy. Results are ordered by `free_float` descending.

<Note>Free float is calculated as the `share_percentage` of the **Public** entry in a company's major shareholders list.</Note>

<Warning>Query parameters are **mutually exclusive**. Provide at most one filter parameter per request.</Warning>

<Info>Costs 1 API credit per 100 companies returned, rounded up.</Info>

## Query parameters

- `sector` string
- `sub_sector` string
- `industry` string
- `sub_industry` string

## Response `200`

Flat list of companies with free float percentage, ordered descending.

- FreeFloatItem[]
  - `symbol` string, required — Ticker symbol (e.g. BBCA.JK).
  - `company_name` string, required — Full company name.
  - `free_float` number, double, required — Free float as a decimal (0.45 = 45%).

## Other responses

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