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
• Analyzing fund manager performance and portfolio allocation
• Benchmarking industry and sector performance based on institutional holdings
• Identifying new or exited positions by major funds
• Understanding industry exposure and concentration in institutional portfolios

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."

Holdings & Ownership Data Fields

Field	Description
Filing Date	Date the 13F or related filing was submitted
CIK	Central Index Key identifying the institutional holder
Holder Name	Name of the institutional investor or fund
Security Symbol	Ticker symbol of the security held
Security Name	Name of the security held
CUSIP	Committee on Uniform Security Identification Procedures identifier
Value	Market value of the position (USD)
Shares Held	Number of shares reported in the filing
Change (%)	Change in position from previous filing
Industry	Industry classification of the security
Sector	Sector classification of the security
Performance Metrics	Returns, alpha, beta, and other analytics (where applicable)
Filing Type	Type of SEC filing (e.g., 13F-HR, 13F-NT)
Reporting Period	Quarter and year of the filing (e.g., Q4 2024)
Portfolio Weight	Percentage of the portfolio allocated to the security
New/Exited Position	Indicates if the position is new or has been exited since last filing