Herfindahl Constituent Concentration
Install and import#
npm install fintech-algorithmsimport { calculate } from "fintech-algorithms/market-breadth-and-internals/concentration-and-diffusion/herfindahl-constituent-concentration";Signature#
calculate(rows)The Herfindahl–Hirschman index of constituent weights: the sum of squared weights. Squaring is what makes it a concentration measure — it is dominated by the largest holdings in a way a simple count never is.
Parameters#
| Name | Type | Notes |
|---|---|---|
rows | Row[] | Constituents with weights. Rows carry a ready flag; a row that is not ready is excluded rather than treated as zero, because a missing count and a count of zero mean opposite things about market breadth. |
Returns#
{ status, hhi, hhi_points }
HHI as a fraction and in the conventional points form, which differ by a factor of 10,000 and are frequently confused.
Errors#
- When weights do not sum to approximately 1 — reported as a status rather than thrown
Complexity: time O(n),
space O(1).
Worked example#
executed Captured by running this function on the input its own test provides. Real output of real code — but not asserted against a published figure.
Input#
[
{
"security_id": "S01",
"weight": 0.17821782178217824,
"return": 0.065,
"sector": "Tech",
"ready": true
},
{
"security_id": "S02",
"weight": 0.13861386138613863,
"return": 0.041,
"sector": "Financials",
"ready": true
},
{
"security_id": "S03",
"weight": 0.10891089108910892,
"return": 0.028,
"sector": "Industrials",
"ready": true
}
]Showing 3 of 24 elements.
Call#
calculate(rows)Returns#
object with 3 fields: status, hhi, hhi_points
{
"status": "resolved",
"hhi": 0.0898088422703657,
"hhi_points": 898.088422703657
}Diagrams#
Calculation flow#
Calculation Flow — Herfindahl Constituent Concentration
flowchart LR
A["Point-in-time component snapshot"] --> B{"Complete, unique, finite?"}
B -->|"No"| X["Incomplete — withhold value"]
B -->|"Yes"| C["Apply Herfindahl Constituent Concentration contract"]
C --> D["Retain component audit trace"]
D --> E["Publish value, unit, parameter, and as-of"]
How it works#
This page states the contract — how to call it correctly. The article explains the concept: why it works, and where it breaks.
References#
- Claim-to-source map
- Herfindahl-Hirschman Index — U.S. Department of Justice, Antitrust Division
- S&P Dow Jones Indices: Index Mathematics Methodology — S&P Dow Jones Indices