{"uid":"cap_nTCvyVHjmy8i2RnW-zm-M","slug":"agents-x402stock-xyz-sec-form-3-initial-beneficial-ownership-holdings-41b055e2","name":"SEC Form 3 Initial Beneficial Ownership Holdings","description":"Initial beneficial-ownership holdings parsed from SEC Form 3 filings, the first report an insider files on becoming a director, officer, or 10% holder. Each holding carries the security, shares owned, direct or indirect ownership, and derivative terms. Complements Form 4 transactions. ?limit= filings (default 5). Sourced from SEC EDGAR. From x402stock, a market & economic data API (x402, USDC).","url":"https://agents.x402stock.xyz/api/v1/form-3/{ticker}","method":"GET","headers":{},"bodySchema":{"type":"object","required":["ticker"],"properties":{"limit":{"type":"integer","default":5,"maximum":25,"exclusiveMinimum":0},"ticker":{"type":"string","description":"US-listed ticker symbol (uppercase), e.g. AAPL."}}},"responseSchema":{"type":"object","required":["ticker","data","source","as_of"],"properties":{"data":{"type":"object","required":["filings_parsed","holding_count","holdings"],"properties":{"holdings":{"type":"array","items":{"type":"object","required":["owner_name","is_director","is_officer","officer_title","is_ten_percent_owner","filing_date","accession","url","security","shares","direct_or_indirect","nature_of_ownership","is_derivative","exercise_price","exercise_date","expiration_date","underlying_security","underlying_shares"],"properties":{"url":{"type":"string"},"shares":{"anyOf":[{"type":"number"},{"type":"null"}]},"security":{"anyOf":[{"type":"string"},{"type":"null"}]},"accession":{"type":"string"},"is_officer":{"type":"boolean"},"owner_name":{"anyOf":[{"type":"string"},{"type":"null"}]},"filing_date":{"type":"string"},"is_director":{"type":"boolean"},"exercise_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_derivative":{"type":"boolean"},"officer_title":{"anyOf":[{"type":"string"},{"type":"null"}]},"exercise_price":{"anyOf":[{"type":"number"},{"type":"null"}]},"expiration_date":{"anyOf":[{"type":"string"},{"type":"null"}]},"underlying_shares":{"anyOf":[{"type":"number"},{"type":"null"}]},"direct_or_indirect":{"anyOf":[{"enum":["D","I"],"type":"string"},{"type":"null"}]},"nature_of_ownership":{"anyOf":[{"type":"string"},{"type":"null"}]},"underlying_security":{"anyOf":[{"type":"string"},{"type":"null"}]},"is_ten_percent_owner":{"type":"boolean"}},"additionalProperties":false}},"holding_count":{"type":"number"},"filings_parsed":{"type":"number"}},"additionalProperties":false},"as_of":{"anyOf":[{"type":"string"},{"type":"null"}]},"source":{"type":"string","const":"sec_edgar"},"ticker":{"type":"string"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.02","displayCostAsset":"USD","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__4v2PoLN-bcWAnYP8SyNn","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.x402stock.xyz","brandSlug":"agents-x402stock-xyz-mpp","brandBaseUrl":"https://agents.x402stock.xyz","brandDocsUrl":null,"whatItDoes":"Returns parsed initial beneficial-ownership holdings from SEC Form 3 filings for a given US stock ticker, showing what insiders owned when they first became directors, officers, or 10%+ holders.","exampleAgentPrompt":"Pull the last 10 SEC Form 3 filings for TSLA and show me what each new insider initially reported owning — including any derivative holdings and whether they're a director, officer, or 10% holder.","exampleUseCases":[{"title":"Vetting new board member ownership","prompt":"I just heard that Apple added a new board member — can you pull their initial SEC Form 3 filing for AAPL and tell me what securities they reported owning when they joined?"},{"title":"Screening for large initial insider stakes","prompt":"Check the last 25 Form 3 filings for NVDA and flag any insiders who came in as 10% holders or reported owning more than a million shares initially."},{"title":"Derivative holdings at time of appointment","prompt":"For META, show me any Form 3 filings where new officers reported derivative holdings — I want to see the exercise prices and expiration dates on anything like options or warrants they disclosed initially."}],"resultDescription":"A JSON object containing the ticker, source (sec_edgar), timestamp, and a data block with: number of filings parsed, total holding count, and an array of holdings. Each holding includes owner name, role flags (director/officer/10% owner), officer title, filing date, accession number, SEC URL, security name, share count, direct/indirect ownership indicator, nature of ownership, and derivative details (is_derivative, exercise price, exercise date, expiration date, underlying security and shares).","failureModes":["Unknown or invalid ticker returns empty data array","Ticker with no Form 3 filings on EDGAR returns zero holdings","Limit parameter out of range (>25 or <=0) returns validation error","Network or EDGAR upstream outage may cause timeout or 5xx error","Payment failure via x402/USDC results in 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need to understand what insiders owned at the moment they first became reportable insiders (directors, officers, or 10%+ holders) for a US-listed stock. It is distinct from Form 4 endpoints (which cover ongoing transactions) and provides the baseline ownership snapshot. Prefer this when researching insider composition, initial equity stakes, or derivative grant details at appointment time.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-12T18:39:47.348Z","isFirstParty":false}