Brokers

Top Brokers Daily Ranking

Changed on

Brokers ranked by gross trade value (default) or absolute net flow for a single date. Optionally filter by origin (foreign/domestic) and cohort (retail/mixed/institutional/unknown). Returns all matching brokers if n_brokers is omitted. Each row also reports the portion of the broker's turnover executed for foreign investors (foreign_gross, foreign_net); pass foreign=true to rank by those instead of the totals.

<Note>Origin and cohort classifications come from the broker registry and describe the broker itself (a foreign- or domestic-owned member), not its clients. Use the foreign_* fields for investor-origin flow. Retrieve the full list with these classifications from the Broker Registry endpoint.</Note>

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

get/v2/brokers/top/

Request

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

Query parameters

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

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

datestring

Target date (YYYY-MM-DD). Default: latest available.

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. With metric=gross ranks by foreign_gross; with metric=net by absolute foreign_net.

metric'gross' | 'net'

gross ranks by total buy + sell value; net ranks by absolute net flow. Default gross.

n_brokersinteger

How many brokers to return. Default: all matching (~88 total). Max 90.

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

Filter by broker origin. Default all.

Response

Ranked brokers with trade values for the target date.

datestring date required
metricstring required
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