Skip to main content

​
yf_ticker_major_holders

Returns a summary of major ownership breakdown for a ticker, showing institutional, insider, and public holdings percentages.

​
Parameters

​
ticker
string
required
Ticker symbol (e.g., “AAPL”, “MSFT”)
​
response_format
enum
default:"json"
Output format: json or markdown
​
preview_limit
integer
default:25
Number of rows to preview in markdown format (max 200)
​
save
object
Save results to file

​
Returns

A DataFrame containing major ownership categories:
  • insidersPercentHeld: Percentage of shares held by insiders
  • institutionsPercentHeld: Percentage of shares held by institutions
  • institutionsFloatPercentHeld: Percentage of float held by institutions
  • institutionsCount: Number of institutional holders

​
Example Usage

const result = await use_mcp_tool({
  server_name: "finmcp",
  tool_name: "yf_ticker_major_holders",
  arguments: {
    ticker: "AAPL",
    response_format: "json"
  }
});

​
Example Response

{
  "data": {
    "__type__": "dataframe",
    "columns": ["Value"],
    "index": [
      "insidersPercentHeld",
      "institutionsPercentHeld",
      "institutionsFloatPercentHeld",
      "institutionsCount"
    ],
    "data": [
      [0.0007],
      [0.6142],
      [0.6154],
      [5983]
    ]
  }
}

​
Use Cases

  • Quickly assess ownership structure before making investment decisions
  • Compare institutional interest across different stocks
  • Identify heavily institutionally-held securities
  • Monitor changes in insider ownership over time

Build docs developers (and LLMs) love

Get started for freeTalk to us