Free Stock Ownership API
for Institutional HoldingsStock Ownership API
for Institutions
Compare ownership APIs by filings, periods, mapping, amendments, percentage basis, limits, and permitted use.
Free stock ownership API: what to choose
“Stock ownership” is not one universal feed. Institutional holdings commonly come from periodic regulatory filings; beneficial-ownership disclosures, insider transactions, mutual-fund holdings, ETF constituents, and an issuer’s shareholder register follow different rules and update schedules. Start by naming the legal or operational dataset you need, then select an API that preserves its reporting period, filing timestamp, source form, identifiers, and amendment history.
For U.S. institutional research, a 13F-based API can answer who reported holding a security and what a reporting manager disclosed at quarter end. It cannot prove the manager still owns the position today, reveal every asset or short position, provide acquisition cost, or reproduce a complete cap table. Display both the reporting period and filing date wherever the data appears so users do not mistake disclosure time for position time.
Most developer searches mean institutional holders from Form 13F, not live beneficial ownership, insider trades, ETF constituents, or a shareholder registry.
13F is a quarterly filing. A normalized API can simplify access, but it cannot turn periodic disclosure into a real-time position feed.
Check request quotas, latest-quarter access, history, commercial-use rights, attribution, exports, and whether an API key or card is required.
Ticker is convenient, but filings use manager and security identifiers. Ownership percentages also require a dated, documented share-count denominator.
Institutional ownership data and 13F holdings fields
A useful institutional ownership API answers two directions: “Which managers reported this security?” and “Which securities did this manager report?” Typical observations contain the reporting period, filing and amendment timestamps, form type, manager name and CIK, issuer name, title of class, source security identifier, mapped ticker and listing, shares or principal amount, reported value and units, put/call indication where applicable, investment discretion, voting authority, and source document link.
Stock institutional holders API by ticker
For a ticker-first workflow, require point-in-time issuer mapping, pagination, sortable reported size, an explicit period, source manager count, and documented amendment handling. A percentage can mean share of the manager’s reported portfolio, share of the issuer’s outstanding stock, or share of the API’s observed institutional total. Confirm the denominator, share class, and date before comparing providers.
13F holdings API for portfolio changes
For change analysis, keep the filing period, original filing date, and amendment date separate. Match the same manager, security, share class, and position type across quarters. A larger reported position may reflect purchases, stock splits, mergers, identifier remapping, options treatment, manager reorganization, or amended data; label the result as a filing-to-filing change rather than an observed trade.
| Field | Use | Check |
|---|---|---|
| ticker / CIK / CUSIP | Resolve issuers and holders | Mapping and share classes |
| period / filingDate | Build ownership history | Quarter versus submission date |
| shares / value | Rank major institutional holders | Units and reported value basis |
| change / ownershipPct | Compare quarters and concentration | Calculation method and denominator |
| formType / accession / amendment | Trace each normalized row to its filing version | Replacement versus additive amendment logic |
| putCall / discretion / voting | Preserve position and control context | Null meaning, shared discretion, and non-equity units |
Stock ownership records are not interchangeable
There is no single filing that reveals every owner of a public company. Institutional investment reports, beneficial-ownership filings, insider transaction forms, and fund portfolio disclosures describe different people, thresholds, dates, and economic interests. A dependable API preserves the source record instead of collapsing them into one unexplained ownership percentage.
| Record | What it can show | Time to preserve | Do not infer |
|---|---|---|---|
| Form 13F | Quarter-end reportable positions of covered institutional investment managers. | Period end, filing date, amendment date. | Exact trade date, current position, or the issuer's full cap table. |
| Schedules 13D / 13G | Certain beneficial owners crossing applicable reporting thresholds, plus later amendments. | Event or obligation date, filing date, amendment sequence. | That every large-looking position appears in 13F or represents passive intent. |
| Forms 3 / 4 / 5 | Reported holdings and transactions of directors, officers, and qualifying beneficial owners. | Transaction date, filing date, ownership nature, amendment. | That a transaction code always means an open-market buy or sale. |
| Fund holdings disclosure | A portfolio's disclosed securities, weights, cash, and sometimes derivatives for a stated period. | Holdings date, publication date, revision or restatement date. | The fund's position on the retrieval date or the parent manager's aggregate ownership. |
If Manager A reports 1.2 million shares in 13F and two funds branded by Manager A disclose 700,000 and 500,000 shares for the same period, summing all three rows produces 2.4 million shares. The fund rows may already be included in the manager-level filing. Store reporting entity, fund, security, period, ownership nature, and source relationship; aggregate only after the hierarchy and coverage are known.
How to compare a free institutional holdings API
1. Define coverage and ownership scope
Write down the market, security types, reporting forms, historical depth, and whether you need holder-by-stock, portfolio-by-manager, or both. U.S. Form 13F covers certain institutional investment managers and reportable securities; it is not a complete cap table.
2. Test freshness, amendments, and history
Use one stable ticker across two quarters. Compare filing dates, amendment handling, duplicate positions, missing identifiers, and the provider’s published refresh policy.
3. Read free-tier and license terms
“Free” may mean a trial, evaluation data, latest-quarter access, non-commercial use, or a small daily quota. Record rate limits, retention rights, attribution, redistribution, and production-use restrictions before integration.
4. Measure completeness and mapping quality
Choose one manager with an amendment, one issuer with multiple share classes, one option position, one renamed security, and one quarter with an obvious corporate action. Compare normalized totals to the source filing, count unmapped rows, and inspect whether the API silently drops positions it cannot resolve.
5. Define freshness honestly
Track at least three times: the quarter-end position date, the filing or amendment timestamp, and your ingestion timestamp. “Updated today” describes processing freshness, not the age of the underlying position. A quality UI should expose all three where relevant.
How to integrate stock ownership data into an app
Request institutional holders by ticker
GET /ownership/institutional?ticker=AAPL&period=2025-12-31
Authorization: Bearer YOUR_API_KEY
{
"ticker": "AAPL",
"period": "2025-12-31",
"holders": [
{"holderCik": "...", "shares": 0, "value": 0}
]
}The endpoint and sample values above are provider-neutral placeholders. Replace them with the selected API’s documented path and schema. Validate the response, cache by reporting period, preserve source identifiers, and show the data date in your UI.
Normalize ownership records safely
Store raw filings or provider payloads separately from normalized rows. Key a version by manager, report period, accession or provider event ID, security identity, and position type; make amendment replacement idempotent. Treat null as unknown rather than zero, preserve unmapped source rows, and separate reported values from derived percentages or quarter changes.
- Ingest by filing or update timestamp so late amendments are not missed.
- Resolve manager and security identity with effective-dated mappings; never join ticker text alone.
- Reconcile row counts and reported-value totals to the source version before publishing.
- Compute ownership percentages only with a compatible share class and dated shares-outstanding denominator.
- Expose period, filing date, amendment state, source, and limitations in the application response.
Use QVeris to find and call ownership data capabilities
QVeris can help a developer or AI agent discover relevant ownership-data capabilities, inspect their input and output schemas, and route a call through a consistent capability layer. Before binding one to a workflow, verify whether it returns 13F manager portfolios, holder-by-security views, beneficial ownership, or another dataset; then inspect period filters, identifiers, amendment metadata, pagination, freshness, quotas, and licensing. The underlying provider still determines what the record means.
- Open the Twelve Data Institutional Holders tool to review the capability for finding institutional holders by ticker.
- Inspect required identifiers and returned fields before binding the capability to an agent workflow.
- Use the QVeris REST API reference for integration details, and keep provider-specific terms visible in your product.
Free stock ownership API questions
Is there a free API for stock ownership data?
Some providers offer free plans or evaluation access for institutional ownership data. Check coverage, filing lag, history, quotas, and license terms; “free” does not always mean unrestricted production use.
What does a stock ownership API return?
Typical fields include security identifiers, holder name or CIK, reporting period, shares held, reported value, ownership percentage, and quarter-over-quarter change.
How current is institutional ownership data?
U.S. datasets commonly rely on Form 13F filings, so they describe periodic disclosed positions rather than real-time holdings.
Can I query institutional holders by ticker?
Many normalized APIs support ticker queries, but source filings rely on identifiers such as CIK and CUSIP. Verify mapping, share classes, and amendment handling.
Does a 13F API show a manager’s current portfolio?
No. It shows reportable positions for a past quarter-end as disclosed later, subject to scope rules and amendments. Label the period and filing date rather than presenting it as live ownership.
Why do institutional ownership percentages differ?
APIs may use different share classes, shares-outstanding dates, holder universes, amendment rules, and aggregation methods. Compare the numerator, denominator, and as-of date—not the percentage alone.