{"uid":"cap_XMOU_BUuLL-E5HVIeOT6V","slug":"stablefinance-dev-6be07d3b","name":"StableFinance SEC 13F Institutional Holdings","description":"SEC 13F positions. Pivot by held security (ticker) or by filer (filer_cik).","url":"https://stablefinance.dev/api/institutional-holdings","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"limit":{"type":"integer","maximum":200,"minimum":1},"ticker":{"type":"string","minLength":1},"filer_cik":{"type":"string","minLength":1},"report_period":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lt":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_gte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"report_period_lte":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["institutional_holdings"],"properties":{"ticker":{"type":"string"},"filer_cik":{"type":"string"},"institutional_holdings":{"type":"array","items":{}}},"additionalProperties":false}}}}},"responseSchema":{"type":"json","example":{"ticker":"AAPL","institutional_holdings":[{"cusip":"037833100","shares":905560000,"ticker":"AAPL","form_type":"13F-HR","value_usd":174580000000,"filer_name":"BERKSHIRE HATHAWAY INC","filing_date":"2026-02-14","report_period":"2025-12-31","name_of_issuer":"APPLE INC","accession_number":"0000950123-26-001234"}]}},"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"limit":50,"ticker":"AAPL","report_period_gte":"2024-01-01","report_period_lte":"2024-06-30"}}},"response":{"_truncated":true,"_originalSize":35900}},"exampleRequest":{"limit":50,"ticker":"AAPL","report_period_gte":"2024-01-01","report_period_lte":"2024-06-30"},"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_VZ_7oTl1m33xNEexCauaC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves SEC 13F institutional holdings data, filterable by stock ticker or filer CIK, with date range support","exampleAgentPrompt":"Show me all institutional holders of NVDA from 13F filings for the report period ending 2024-06-30, up to 50 results.","exampleUseCases":null,"resultDescription":"Returns an array of institutional holdings records including the ticker, filer CIK, and detailed position data drawn from SEC 13F filings. Results can be scoped to a specific security or a specific filer institution, optionally filtered to a date range.","failureModes":["Unknown ticker returns empty holdings array","Invalid filer_cik returns empty results","Malformed report_period date (not YYYY-MM-DD) returns validation error","No matching holdings for date range returns empty array","Exceeding limit maximum of 200 returns schema validation error","Missing both ticker and filer_cik may return unfiltered or large result set"],"whenToPreferThis":"Use this endpoint when you need SEC-sourced 13F institutional ownership data for a specific stock or institutional filer, especially when you want to filter by reporting period. Prefer this over general news or market data sources when you need regulatory-grade, timestamped institutional position data rather than estimated or real-time ownership.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:45:05.008Z","isFirstParty":false}