Stock Ownership
Tracked institutional 13F holdings with an explicit coverage disclosure.
Playground keys are masked and used only for this browser-initiated test. The docs proxy forwards X-API-Key to POST /v1/tools/* and does not store it server-side. Fumadocs may keep the auth value in browser localStorage while this endpoint page is open; StockContext clears it when you leave or unload the page.
Serve the tracked institutional managers who reported holding a symbol (from their 13F-HRs).
This is a TRACKED SUBSET, never exhaustive: the payload always carries a coverage block
(exhaustive: false, managers_tracked) and each holder its report_period — it can
never be read as total institutional ownership. An unknown symbol refuses no_match; a
covered symbol no tracked manager holds refuses no_tracked_holders WITH coverage echoed.
Authorization
ApiKeyAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Request for stock_ownership.
Response Body
application/json
application/json
curl -X POST "https://api.stockcontext.com/v1/tools/stock_ownership" \ -H "X-API-Key: $STOCKCONTEXT_API_KEY" \ -H "Content-Type: application/json" \ -d '{"symbol":"AAPL"}'{
"subject": {
"entity": {
"cik": "0000320193",
"name": "Apple Inc.",
"entity_type": "operating"
},
"security": {
"security_id": "sec_aapl_common",
"ticker": "AAPL"
}
},
"data": {
"coverage": {
"basis": "tracked_managers",
"managers_tracked": 20,
"exhaustive": false,
"as_of_note": "13F holdings are filed up to 45 days after quarter-end"
},
"tracked_holders": [
{
"provenance": "sec_filing",
"manager_cik": "0000820434",
"manager": "PVG ASSET MANAGEMENT CORP",
"report_period": "2026-06-30",
"accession": "0000820434-26-000005",
"filed": "2026-07-01",
"positions": [
{
"cusip": "037833100",
"value": "2769320",
"shares": "9571"
}
]
},
{
"provenance": "sec_filing",
"manager_cik": "0001126395",
"manager": "EASTERN BANK",
"report_period": "2026-06-30",
"accession": "0001126395-26-000004",
"filed": "2026-07-01",
"positions": [
{
"cusip": "037833100",
"value": "337230811",
"shares": "1165437"
}
]
}
]
},
"meta": {
"schema_version": "1",
"as_of": {
"sec": "2026-07-01"
},
"basis": "thirteenf_as_filed"
}
}{
"detail": [
{
"loc": [
"string"
],
"msg": "string",
"type": "string",
"input": null,
"ctx": {}
}
]
}