Brokers

Top Accumulations and Distributions Per Broker

Changed on

Returns the stocks a single broker has been most actively accumulating and distributing over a date range. top_accumulations ranks stocks the broker has net bought (largest positive net IDR first); top_distributions ranks stocks the broker has net sold (largest negative net IDR first). Each entry also reports how much of that 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 stocks the broker's foreign clients are moving. Useful for tracking a specific broker's directional positioning across the IDX universe.

<Note>Broker codes are the two-letter exchange-member identifiers (e.g. MG, AK, CC). Retrieve the full list of valid codes from the Broker Registry endpoint.</Note>

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

get/v2/broker-activity/{broker_code}/top/

Request

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

Path parameters

broker_codestring required

Broker code. E.g. MG, AK, CC.

Query parameters

startstring

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

endstring

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

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. Accumulations and distributions are then ranked by foreign_net_idr.

n_brokersinteger

How many accumulations and distributions to return each (default 10, max 90).

Response

Top accumulations and distributions for the broker over the date range.

broker_codestring required
startstring date required
endstring date 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