Top Brokers Daily Ranking
Changed onBrokers 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>
Request
- Base URLhttps://api.sectors.app
- URLhttps://api.sectors.app/v2/brokers/top/
- AuthAPI key in header Authorization
Query parameters
Filter by broker cohort (case-insensitive). Default all.
Target date (YYYY-MM-DD). Default: latest available.
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.
gross ranks by total buy + sell value; net ranks by absolute net flow. Default gross.
How many brokers to return. Default: all matching (~88 total). Max 90.
Filter by broker origin. Default all.
Response
Ranked brokers with trade values for the target date.
Changes
- info
added the new optional
queryrequest parameterforeign - 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