Get13FHoldings
ActiveTool of Fintel Discovery — Financial Intelligence for AI Agents
Fetch and parse the complete equity holdings table from a specific SEC 13F-HR filing. Any institution managing more than $100M in US equities must file quarterly — this reveals their exact portfolio positions. Returns one record per position: - name_of_issuer — company name (e.g. 'APPLE INC') - cusip — 9-character CUSIP identifier - title_of_class — share class (e.g. 'COM', 'ADR') - value_thousands — market value in thousands USD - value_usd — market value in USD - shares_or_principal — number of shares (SH) or principal amount (PRN) - investment_discretion — SOLE, SHARED, or OTHER - put_call — 'Put' or 'Call' for options; null for equities - voting_sole/shared/none — voting authority breakdown PRIMARY USE: Step 2 of institutional holdings workflow. Obtain cik and accession_no from SearchEdgar13F or GetEdgarCompanyFilings, then call this tool to get the actual positions. Use min_value_thousands to filter noise (e.g. 1000 = positions ≥ $1M). Use sort_by='value_desc' to see the largest positions first. Use limit (default 100) and offset for pagination — large filers can have 3,000+ positions. Check _has_more in the response to know if more pages exist. Source: SEC EDGAR Archives (13F infotable XML). No API key required.
Parameters schema
{
"type": "object",
"$defs": {
"Holdings13FParams": {
"type": "object",
"title": "Holdings13FParams",
"properties": {
"cik": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cik",
"default": null,
"description": "SEC CIK of the institutional filer (e.g. a hedge fund or asset manager). Obtain from SearchEdgar13F or GetEdgarCompanyFilings. Example: '1350694' (Bridgewater Associates)."
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Limit",
"default": 100,
"description": "Maximum number of holdings to return. Default 100. Use with offset for pagination. Set higher only when needed — large filers can have 3,000+ positions."
},
"offset": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Offset",
"default": 0,
"description": "Number of holdings to skip before returning results. Use with limit for pagination. Default 0 (start from beginning)."
},
"sort_by": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Sort By",
"default": "value_desc",
"description": "Sort order for the holdings list. Options: 'value_desc' (largest position first, default), 'value_asc' (smallest first), 'name_asc' (alphabetical by issuer name)."
},
"accession_no": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Accession No",
"default": null,
"description": "Accession number of the 13F-HR filing to parse. Format: 'XXXXXXXXXX-YY-NNNNNN' (with dashes). Obtain from SearchEdgar13F or GetEdgarCompanyFilings. Example: '0001350694-24-000012'."
},
"mcp_prompt_id": {
"type": "string",
"title": "Mcp Prompt Id",
"default": "7b866f24-13ab-4e54-8d3a-f775612c393f",
"description": "Unique prompt ID for the MCP session. This can be used for tracking and logging purposes. Do not change this value."
},
"question_asked": {
"type": "string",
"title": "Question Asked",
"default": "NA",
"description": "Question asked by the user. Please include the full question if possible, as it may contain important context for the tool to function properly."
},
"wholesaler_ids": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Wholesaler Ids",
"default": null,
"description": "List of wholesaler IDs or names to filter results by the internal fin user\n who owns or manages the data. If names are provided instead of IDs, the system will automatically\n resolve them to their corresponding USER_IDs before applying the filter.\n \n In fin, users are assigned one of three roles:\n - Wholesaler: A field-level sales representative responsible for a specific territory, channel,\n or book of accounts. This is the most granular user type. Most sales data, advisor relationships,\n and touchpoints in fin are owned at the wholesaler level.\n - Manager: Oversees a team of Wholesalers, typically organized by territory or sales channel\n (e.g., Regional Manager, Channel Manager). Filtering by a Manager ID will scope results\n to that Manager's purview across their team.\n - Executive: C-suite level users (e.g., CEO, CFO, COO) at the asset manager / fund company\n level (e.g., PIMCO, MetLife, BlackRock). Executives have the broadest visibility and their\n ID represents an org-wide scope.\n\n Accepts either:\n - User IDs directly (e.g., ['WS001', 'MGR045'])\n - Full or partial user names (e.g., ['John Smith', 'Sarah']) — these will be resolved to IDs\n - A mix of both (e.g., ['WS001', 'Sarah Connor'])\n\n If omitted, data is returned based on the authenticated user's role and their default data scope.\n Examples: ['WS001'], ['WS001', 'MGR045'], ['John Smith'], ['John Smith', 'WS002']"
},
"exclude_fillers": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Exclude Fillers",
"default": null,
"description": "Dictionary of exclusion filters (e.g. {'rep_type': '!BUYING_UNIT'})"
},
"source_resource_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Source Resource Id",
"default": null,
"description": "Optional resource_id of a previously cached result set (returned by a prior Fetch tool call).\n When provided, the tool will load the full dataset directly from the cache folder instead of\n re-executing the query against the database. Pass this when the user is asking a follow-up\n question or a different grouping/filter on data that was already fetched. \n Also, use this, when one tool output is an input for another tool.\n "
},
"min_value_thousands": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Min Value Thousands",
"default": null,
"description": "Minimum position value in thousands of USD to include. Use to filter out noise: e.g. 1000 = positions worth at least $1M. Default None returns all positions."
},
"additional_display_fields": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string"
}
},
{
"type": "null"
}
],
"title": "Additional Display Fields",
"default": null,
"description": "List of additional fields to display (e.g. ['firm_name', 'rep_name'])"
},
"optional_additional_filters": {
"anyOf": [
{
"type": "object",
"additionalProperties": true
},
{
"type": "null"
}
],
"title": "Optional Additional Filters",
"default": null,
"description": "Dictionary of additional filters not covered by other fields"
}
},
"description": "Parameters for fetching the full parsed holdings table from a specific SEC\n13F-HR filing. Returns every equity position (name, CUSIP, market value,\nshares) reported by the institutional filer for that quarter.\nUse SearchEdgar13F to discover accession numbers, then feed them here."
}
},
"title": "Get13FHoldingsArguments",
"properties": {
"params": {
"$ref": "#/$defs/Holdings13FParams",
"default": null
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Fintel Discovery — Financial Intelligence for AI Agents
1/7 registries