FMP Node API Documentation
Institutional Endpoints
The Institutional Endpoints provide access to Form 13F filings, institutional ownership data, and institutional holder information. These endpoints help you track institutional investment activities and ownership patterns.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /form-thirteen/{cik} | Get Form 13F institutional stock ownership data |
| GET | /form-thirteen-date/{cik} | Get available Form 13F filing dates for an institution |
| GET | /institutional-holder/{symbol} | Get institutional holders for a specific stock |
Get Form 13F Data
Retrieve Form 13F institutional stock ownership data for a specific CIK (Central Index Key) and filing date. Form 13F reports are filed quarterly by institutional investment managers with at least $100 million in assets under management.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| cik | string | Yes | Central Index Key (CIK) of the institutional investor (10-digit number with leading zeros) |
| date | string | Yes | Filing date in YYYY-MM-DD format (quarterly filing dates: 03-31, 06-30, 09-30, 12-31) |
Example Response
Get Form 13F Dates
Retrieve available Form 13F filing dates for a specific institutional investor (CIK). This helps you identify which quarters have been filed and are available for analysis.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| cik | string | Yes | Central Index Key (CIK) of the institutional investor (10-digit number with leading zeros) |
Example Response
Get Institutional Holders
Retrieve information about institutional holders for a specific stock symbol. This data shows which institutional investors own shares in the company and their current positions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol (e.g., "AAPL", "MSFT", "GOOGL") |
Example Response
Understanding Form 13F Data
Form 13F reports provide valuable insights into institutional investment strategies:
Key Fields Explained
- cik: Central Index Key - unique identifier for the institutional investor
- cusip: Committee on Uniform Securities Identification Procedures - unique identifier for the security
- nameOfIssuer: Company name of the security issuer
- tickercusip: Stock ticker symbol
- titleOfClass: Class of security (usually "COM" for common stock)
- shares: Number of shares held
- value: Total market value of the position (in USD)
- date: Quarter-end date of the filing
- acceptedDate: Date the SEC accepted the filing
- fillingDate: Date the filing was submitted
Common CIKs
Some well-known institutional investors and their CIKs:
- BlackRock Inc.: 0001364742
- Vanguard Group Inc.: 0000102909
- State Street Corporation: 0000093751
- Fidelity Management: 0000315066
- T. Rowe Price: 0001113169
Use Cases
1. Track Institutional Sentiment
Monitor how institutional investors are positioning themselves in specific stocks or sectors.
2. Monitor Specific Institutions
Track the holdings of specific institutional investors across different companies.
3. Sector Analysis
Analyze institutional ownership patterns across different sectors.
Error Handling
Always check the success property before accessing data:
Rate Limiting
Institutional endpoints are subject to FMP's rate limits. For production applications, implement appropriate rate limiting and caching strategies.
Data Availability
- Form 13F Data: Available quarterly (45 days after quarter-end)
- Institutional Holders: Updated regularly based on latest filings
- Historical Data: Limited by filing requirements and data availability
Next Steps
Explore other endpoint categories:
- Stock Endpoints - Real-time quotes and historical data
- Company Endpoints - Company profiles and executive data
- Financial Endpoints - Financial statements and ratios
- Market Endpoints - Market indices and sector data
- Calendar Endpoints - Earnings and economic calendars
- Examples - Practical code samples
Ready to analyze institutional data? Check out the Financial Endpoints for comprehensive financial analysis tools.
Documentation
Quotes
Information
Resources
Institutional Endpoints
The Institutional Endpoints provide access to Form 13F filings, institutional ownership data, and institutional holder information. These endpoints help you track institutional investment activities and ownership patterns.
Available Methods
| Method | Endpoint | Description |
|---|---|---|
| GET | /form-thirteen/{cik} | Get Form 13F institutional stock ownership data |
| GET | /form-thirteen-date/{cik} | Get available Form 13F filing dates for an institution |
| GET | /institutional-holder/{symbol} | Get institutional holders for a specific stock |
Get Form 13F Data
Retrieve Form 13F institutional stock ownership data for a specific CIK (Central Index Key) and filing date. Form 13F reports are filed quarterly by institutional investment managers with at least $100 million in assets under management.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| cik | string | Yes | Central Index Key (CIK) of the institutional investor (10-digit number with leading zeros) |
| date | string | Yes | Filing date in YYYY-MM-DD format (quarterly filing dates: 03-31, 06-30, 09-30, 12-31) |
Example Response
Get Form 13F Dates
Retrieve available Form 13F filing dates for a specific institutional investor (CIK). This helps you identify which quarters have been filed and are available for analysis.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| cik | string | Yes | Central Index Key (CIK) of the institutional investor (10-digit number with leading zeros) |
Example Response
Get Institutional Holders
Retrieve information about institutional holders for a specific stock symbol. This data shows which institutional investors own shares in the company and their current positions.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| symbol | string | Yes | Stock symbol (e.g., "AAPL", "MSFT", "GOOGL") |
Example Response
Understanding Form 13F Data
Form 13F reports provide valuable insights into institutional investment strategies:
Key Fields Explained
- cik: Central Index Key - unique identifier for the institutional investor
- cusip: Committee on Uniform Securities Identification Procedures - unique identifier for the security
- nameOfIssuer: Company name of the security issuer
- tickercusip: Stock ticker symbol
- titleOfClass: Class of security (usually "COM" for common stock)
- shares: Number of shares held
- value: Total market value of the position (in USD)
- date: Quarter-end date of the filing
- acceptedDate: Date the SEC accepted the filing
- fillingDate: Date the filing was submitted
Common CIKs
Some well-known institutional investors and their CIKs:
- BlackRock Inc.: 0001364742
- Vanguard Group Inc.: 0000102909
- State Street Corporation: 0000093751
- Fidelity Management: 0000315066
- T. Rowe Price: 0001113169
Use Cases
1. Track Institutional Sentiment
Monitor how institutional investors are positioning themselves in specific stocks or sectors.
2. Monitor Specific Institutions
Track the holdings of specific institutional investors across different companies.
3. Sector Analysis
Analyze institutional ownership patterns across different sectors.
Error Handling
Always check the success property before accessing data:
Rate Limiting
Institutional endpoints are subject to FMP's rate limits. For production applications, implement appropriate rate limiting and caching strategies.
Data Availability
- Form 13F Data: Available quarterly (45 days after quarter-end)
- Institutional Holders: Updated regularly based on latest filings
- Historical Data: Limited by filing requirements and data availability
Next Steps
Explore other endpoint categories:
- Stock Endpoints - Real-time quotes and historical data
- Company Endpoints - Company profiles and executive data
- Financial Endpoints - Financial statements and ratios
- Market Endpoints - Market indices and sector data
- Calendar Endpoints - Earnings and economic calendars
- Examples - Practical code samples
Ready to analyze institutional data? Check out the Financial Endpoints for comprehensive financial analysis tools.