---
title: "Market-wide 13F holder flows for a closed quarter: what each kind of filer bought and sold of 13F common shares, its net flow, net flow as a percentage of its prior 13F book, and net buyers against net sellers. Trades are each filer's share changes priced at the security's average close over the quarter, else its quarter-end value per share (an exit at the quarter before's); options and principal amounts are left out, and a share change from a corporate action reads as a trade. Only filers with a 13F the quarter before are compared. Holder type is each filer's current regulatory profile, never its name; client base and private funds come from the Form ADV roster current at the quarter end (rosters from December 2019); style, turnover, horizon and book size are measured from its own 13F book that quarter. With groupBy=sector each bucket's flow is split by its issuers' sectors, with exchange-traded products apart. Quarters still in their 13F filing window are not computed."
method: GET
path: "/v1/13f/flows"
tags: ["HolderFlows"]
---

# Market-wide 13F holder flows for a closed quarter: what each kind of filer bought and sold of 13F common shares, its net flow, net flow as a percentage of its prior 13F book, and net buyers against net sellers. Trades are each filer's share changes priced at the security's average close over the quarter, else its quarter-end value per share (an exit at the quarter before's); options and principal amounts are left out, and a share change from a corporate action reads as a trade. Only filers with a 13F the quarter before are compared. Holder type is each filer's current regulatory profile, never its name; client base and private funds come from the Form ADV roster current at the quarter end (rosters from December 2019); style, turnover, horizon and book size are measured from its own 13F book that quarter. With groupBy=sector each bucket's flow is split by its issuers' sectors, with exchange-traded products apart. Quarters still in their 13F filing window are not computed.

`GET /v1/13f/flows`

## Request

- Base URL: `https://api.equibles.com`
- URL: `https://api.equibles.com/v1/13f/flows`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/equibles/apis/equibles-api/docs/v1/13f/flows/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `dimension` string
- `reportDate` string, date
- `groupBy` string
- `bucket` string

## Response `200`

OK

- HolderFlowsResponse: One closed quarter's 13F holder flows by the buckets of one dimension.
  - `reportDate` string, date
  - `previousReportDate` string, date: The quarter the trades are measured against.
  - `dimension` string, nullable: The dimension token: type, style, turnover, horizon, aum, client, pf or country.
  - `dimensionLabel` string, nullable
  - `groupBy` string, nullable: none or sector.
  - `sectorSplitAvailable` boolean: False until the quarter is recomputed with per-sector trades; sectors stay null until then.
  - `computedAt` string, date-time: When the quarter's flows were last computed (UTC).
  - `buckets` HolderFlowBucketDto[], nullable
    - `token` string, nullable: A stable token for the bucket, such as adv, idx or nonus; all for the total.
    - `label` string, nullable
    - `filers` integer
    - `comparedFilers` integer: Filers with a 13F the quarter before, whose trades are counted.
    - `equityAum` integer: Every filer's 13F common-share value this quarter, in dollars.
    - `priorEquityAum` integer: The compared filers' 13F common-share value the quarter before, in dollars.
    - `boughtValue` number, double: Dollars bought: share increases priced at the quarter's average close, else the quarter-end value per share.
    - `soldValue` number, double: Dollars sold, priced the same way; an exit at the quarter before's value per share.
    - `netValue` number, double
    - `netPercentOfPriorBook` number, double, nullable: Net flow as a percentage of priorEquityAum; null without a prior book.
    - `netBuyers` integer: Compared filers that bought more than they sold.
    - `netSellers` integer: Compared filers that sold more than they bought.
    - `unpricedTrades` integer: Trades with no price on either side, left out of the dollar values.
    - `sectors` HolderSectorFlowDto[], nullable: The flow per sector when groupBy=sector and the split is available; otherwise null.
      - `group` string, nullable: sector, exchangeTraded or unclassified.
      - `name` string, nullable: The sector's name, Exchange-traded products, or Unclassified.
      - `boughtValue` number, double
      - `soldValue` number, double
      - `netValue` number, double
  - `total` HolderFlowBucketDto: One bucket's money in and out of 13F common shares over the quarter. Only filers with a 13F the quarter before are compared; the rest are counted and add no flow.
    - `token` string, nullable: A stable token for the bucket, such as adv, idx or nonus; all for the total.
    - `label` string, nullable
    - `filers` integer
    - `comparedFilers` integer: Filers with a 13F the quarter before, whose trades are counted.
    - `equityAum` integer: Every filer's 13F common-share value this quarter, in dollars.
    - `priorEquityAum` integer: The compared filers' 13F common-share value the quarter before, in dollars.
    - `boughtValue` number, double: Dollars bought: share increases priced at the quarter's average close, else the quarter-end value per share.
    - `soldValue` number, double: Dollars sold, priced the same way; an exit at the quarter before's value per share.
    - `netValue` number, double
    - `netPercentOfPriorBook` number, double, nullable: Net flow as a percentage of priorEquityAum; null without a prior book.
    - `netBuyers` integer: Compared filers that bought more than they sold.
    - `netSellers` integer: Compared filers that sold more than they bought.
    - `unpricedTrades` integer: Trades with no price on either side, left out of the dollar values.
    - `sectors` HolderSectorFlowDto[], nullable: The flow per sector when groupBy=sector and the split is available; otherwise null.
      - `group` string, nullable: sector, exchangeTraded or unclassified.
      - `name` string, nullable: The sector's name, Exchange-traded products, or Unclassified.
      - `boughtValue` number, double
      - `soldValue` number, double
      - `netValue` number, double
  - `availableReportDates` string[], nullable: Every computed quarter, newest first.

## Other responses

- `400`: Bad Request
- `404`: Not Found

---

[API](https://skmtc.dev/equibles/apis/equibles-api.md) - [All operations](https://skmtc.dev/equibles/apis/equibles-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equibles/apis/equibles-api/revisions/666e06778588?raw)