Brokers

Top Buyers and Sellers Per Symbol

Changed on

Returns the brokers most actively accumulating and distributing a single IDX ticker over a date range. top_buyers ranks brokers by net buy value (largest positive net IDR first); top_sellers ranks brokers by net sell value (largest negative net IDR first). Each entry also reports how much of that broker's flow was executed for foreign investors (foreign_net_idr, foreign_buy_idr, foreign_sell_idr); pass foreign=true to rank by foreign_net_idr instead, i.e. the top foreign buyers and sellers of the stock. Useful for spotting institutional accumulation or distribution patterns on a specific stock.

<Note>IDX symbol: 4 letters, optionally followed by .jk (case-insensitive). E.g. BBCA, GOTO.</Note>

<Note>The origin filter uses the broker's registry classification (a foreign- or domestic-owned member), not the origin of its clients. Use the foreign_* fields for investor-origin flow.</Note>

<Info>Costs 2 API credits.</Info>

get/v2/broker-summary/{symbol}/top/

Request

  • Base URL
    https://api.sectors.app
  • URL
    https://api.sectors.app/v2/broker-summary/{symbol}/top/
  • Auth
    API key in header Authorization

Path parameters

symbolstring required

IDX ticker symbol. E.g. BBCA, GOTO.

Query parameters

startstring

Start date (YYYY-MM-DD). Default: end - 90 days.

endstring

End date (YYYY-MM-DD). Default: today.

cohort'all' | 'institutional' | 'mixed' | 'retail' | 'unknown'

Filter brokers by cohort (case-insensitive). Default all.

foreignboolean

If true, rank by the foreign-investor portion of each broker's flow instead of the total. Bare ?foreign also means true; any value other than true/false returns 400. Default false. Buyers and sellers are then ranked by foreign_net_idr.

n_brokersinteger

How many buyers and sellers to return each (default 10, max 90).

origin'all' | 'domestic' | 'foreign'

Filter brokers by origin. Default all.

Response

Top net buyers and top net sellers for the symbol over the date range.

symbolstring required

Ticker symbol.

startstring date required

Range start date.

endstring date required

Range end date.

originstring required
cohortstring required
foreignboolean required

Whether the ranking used foreign-investor flow.

Changes

    • info

      added the new optional query request parameter foreign

    • info

      added the non-success response with the status

    • info

      added the required property to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status

    • info

      added the required property // to the response with the status