Octagon Holdings Agent

Model Name: octagon-holdings-agent

Specialized agent for institutional ownership and holdings data, providing comprehensive insights into Form 13F filings, institutional investor activity, fund performance, and industry-level holdings analytics.

Capabilities

• Retrieve the latest Form 13F and related institutional ownership filings
• Analyze institutional holder filings for specific securities and periods
• Summarize performance of institutional holders (funds, asset managers)
• Break down institutional portfolios by industry/sector
• Summarize institutional positions for a given security
• Benchmark industry performance based on institutional holdings

Use Cases

The Holdings Agent is best for:

• Tracking institutional buying and selling activity for specific stocks across quarters
• Analyzing fund manager performance and portfolio allocation
• Benchmarking industry and sector performance based on institutional holdings
• Identifying new or exited positions by major funds to get insight into where institutional money is flowing
• Understanding industry exposure and concentration in institutional portfolios
• Benchmark fund ownership and monitor investor movement

Example Queries

Get Latest Institutional Ownership Filings

Fetch the most recent Form 13F and related filings submitted by institutional investors.

@octagon-holdings-agent Retrieve the most recent Form 13F and related filings submitted by institutional investors, limited to 50 records on page 0.

Get Holder Filings Analytics

Retrieve analytics for institutional holder filings for a specific security (e.g., AAPL) in a given quarter.

@octagon-holdings-agent Retrieve analytics for institutional holder filings for AAPL in Q2 of 2023, limited to 20 records on page 0.

Get Holder Performance Summary

Get a summary of the performance of a specific institutional holder, identified by CIK.

@octagon-holdings-agent Get a summary of the performance of the institutional holder with CIK 0001166559.

Get Holder Industry Breakdown

Retrieve the industry breakdown for a specific holder (by CIK) for a given quarter.

@octagon-holdings-agent Retrieve the industry breakdown for the holder with CIK 0001067983 for Q4 of 2024.

Get Symbol Positions Summary

Get a summary of institutional positions for a specific security (e.g., AAPL) for a given quarter.

@octagon-holdings-agent Get a summary of institutional positions for AAPL for Q4 of 2024.

Get Industry Performance Summary

Get a financial performance summary for all industries for a given quarter.

@octagon-holdings-agent Get a financial performance summary for all industries for Q4 of 2024.

Code Examples

Python

response = client.responses.create(
    model="octagon-holdings-agent",
    input="Retrieve analytics for institutional holder filings for AAPL in Q2 of 2023, limited to 20 records on page 0."
)

JavaScript

const response = await client.responses.create({
  model: "octagon-holdings-agent",
  input: "Get a summary of institutional positions for AAPL for Q4 of 2024."
});

cURL

curl -X POST https://api-gateway.octagonagents.com/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer your-octagon-api-key" \
  -d '{
    "model": "octagon-holdings-agent",
    "input": "Retrieve the most recent Form 13F and related filings submitted by institutional investors, limited to 50 records on page 0.",
    "stream": true
  }' \
  --no-buffer

How to Create Effective Prompts for Holdings & Ownership Analysis

When querying institutional holdings data, consider these strategies:

1. Specify the security or holder: Indicate the stock symbol, CIK, or fund name for targeted results.
   • Example: "Retrieve analytics for institutional holder filings for TSLA in Q1 of 2024."
2. Define the reporting period: Use specific quarters or years for filings and analytics.
   • Example: "Get a summary of institutional positions for MSFT for Q3 of 2023."
3. Request breakdowns or summaries: Ask for industry, sector, or performance breakdowns.
   • Example: "Retrieve the industry breakdown for the holder with CIK 0001067983 for Q4 of 2024."
4. Limit the number of records: Specify limits for pagination or focused results.
   • Example: "Retrieve the most recent Form 13F filings, limited to 25 records."
5. Compare across periods or holders: Request comparative analytics for deeper insights.
   • Example: "Compare institutional ownership changes for NVDA between Q2 and Q3 of 2023."

Institutional Ownership Data Fields

Field	Description
Filing Date	Date of SEC filing submission (e.g., 13F, 10-K, 10-Q, 8-K).
CIK	Unique SEC identifier for the filing institution or company.
Holder Name	Name of the institutional investor or fund (e.g., BlackRock).
Security Symbol	Ticker symbol of the held security (e.g., AAPL).
Security Name	Full name of the security (e.g., Apple Inc.).
CUSIP	Unique 9-character identifier for the security.
Shares Held	Total shares of the security reported in the filing.
Filing Type	Type of SEC filing (e.g., 13F-HR, 10-K, 8-K).
Filing Link	URL to the SEC filing document on EDGAR.
Reporting Period	Quarter and year of the filing (e.g., Q4 2024).
New/Exited Position	Indicates new or exited positions since last filing.
Number of Investors	Count of institutional investors holding a specific stock.

Holdings Performance Summary Data Fields

Field	Description
Value	Market value of the position in USD.
Change (%)	Percentage change in shares held from prior filing.
Industry	Security’s industry per SIC classification (e.g., Software).
Sector	Security’s market sector (e.g., Technology, Healthcare).
Performance Metrics	Portfolio metrics like returns, alpha, and beta.
Portfolio Weight	Security’s percentage of the investor’s portfolio.
Portfolio Changes	Stock movements (e.g., increases, decreases) in the portfolio.
Industry Allocation	Portfolio distribution across industries.
SIC Code	Standard Industrial Classification code for the security’s industry.
Investment Strategy	Insights into investor’s strategy (e.g., sector focus).