# Get Top Sectors/Themes by Flow

Returns a ranked list of the top entities (sectors or themes) based on 
inbound/outbound flow over the specified period.

Endpoint: GET /aggregates/top_flows
Version: 0.1.0
Security: HTTPBearer

## Query parameters:

  - `scope` (string, required)
    The entity type to aggregate (sector or theme).
    Enum: "sector", "theme"

  - `period` (string, required)
    The comparison period for the flow (WoW, DoD, MoM).
    Enum: "DoD", "WoW", "MoM"

## Response 200 fields (application/json):

  - `id` (string, required)

  - `name` (string, required)

  - `type` (string, required)
    Available scope for top flow aggregation.
    Enum: "sector", "theme"

  - `flow_value` (number, required)

  - `change_pct` (number, required)

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)

  - `detail.msg` (string, required)

  - `detail.type` (string, required)