diff_holdings
Compare two 13F quarter-end holdings for a manager on a shared as-of date to identify position-level changes, and filter by issuer or CUSIP to narrow large filings.
Instructions
Position-level changes between period_a and period_b, each computed with get_holdings_as_of rules on the same as_of and consolidated by (cusip, put_call, sh_prn). Large managers file tens of thousands of rows: narrow with issuer, cusip or max_positions. as_of means what was publicly filed by that date.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"cik": "<cik>",
"period_a": "<period_a>",
"period_b": "<period_b>",
"as_of": "<as_of>"
},
"name": "diff_holdings"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cik | Yes | SEC Central Index Key; leading zeros optional. Resolve a manager's name to its CIK with find_manager. | |
| as_of | Yes | ISO-8601 knowledge date: the answer uses only what was publicly filed on EDGAR by this date. | |
| cusip | No | ||
| issuer | No | Keep only rows whose name_of_issuer contains this text (case-insensitive, whitespace collapsed); combined with cusip as AND. The response lists matched_cusips. | |
| period_a | Yes | Form 13F report period: a calendar quarter-end date. | |
| period_b | Yes | Form 13F report period: a calendar quarter-end date. | |
| max_positions | No | Return only the largest positions (by value); the response adds total_positions, truncated and order. |