{"uid":"cap__dbFhOzp5yAd5eMeae6Yt","slug":"x402-factory-sec-form-4-insider-transactions-3e0dbcd4","name":"x402-factory SEC Form 4 Insider Transactions","description":"Normalized insider transactions (Form 4) with flow aggregates for a ticker — SEC Form 4 filings parsed into clean insider transactions: buy/sell/award classification, 10b5-1 plan flags, per-filer roles, and aggregate net flow with notable-pattern flags. Use it to gauge insider conviction before events.","url":"https://x402-factory.com/v1/edgar/insider/:ticker","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"],"type":"string"},"pathParams":{"type":"object","required":["ticker"],"properties":{"ticker":{"type":"string","pattern":"^[A-Za-z][A-Za-z.-]*$","maxLength":6,"minLength":1}}},"queryParams":{"type":"object","required":[],"properties":{"days":{"type":"integer","default":30,"maximum":90,"minimum":1,"description":"Lookback window in days"},"min_value_usd":{"type":"number","minimum":0,"description":"Drop transactions below this absolute USD value"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["data","meta"],"properties":{"data":{"type":"object","required":["ticker","company","window_days","transactions","aggregates"],"properties":{"ticker":{"type":"string"},"company":{"type":"string"},"aggregates":{"type":"object","required":["net_insider_flow_30d_usd","buy_count","sell_count","notable_flags"],"properties":{"buy_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"sell_count":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"notable_flags":{"type":"array","items":{"type":"string"}},"net_insider_flow_30d_usd":{"type":"number"}},"additionalProperties":false},"window_days":{"type":"integer","maximum":9007199254740991,"minimum":-9007199254740991},"transactions":{"type":"array","items":{"type":"object","required":["filer_name","filer_role","type","is_10b5_1","shares","price","value_usd","transaction_date","filed_at","accession"],"properties":{"type":{"enum":["buy","sell","award","other"],"type":"string"},"price":{"type":"number"},"shares":{"type":"number"},"filed_at":{"type":"string"},"accession":{"type":"string"},"is_10b5_1":{"type":"boolean"},"value_usd":{"type":"number"},"filer_name":{"type":"string"},"filer_role":{"type":"string"},"transaction_date":{"type":"string"}},"additionalProperties":false}}},"additionalProperties":false},"meta":{"type":"object"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","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":"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_8yNda7DowpI9HeMODjvZa","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":"Returns parsed SEC Form 4 insider transactions for a ticker with buy/sell/award classification, 10b5-1 plan flags, per-filer roles, and aggregate net insider flow over a configurable lookback window.","exampleAgentPrompt":"Pull insider transaction data for NVDA from SEC Form 4 filings over the last 60 days — I want to see who's buying or selling, whether any trades are on 10b5-1 plans, and what the net insider flow looks like.","exampleUseCases":null,"resultDescription":"Returns a structured object containing the ticker and company name, a list of individual insider transactions (each with filer name, role, transaction type buy/sell/award/other, 10b5-1 flag, shares, price, USD value, transaction date, filing date, and accession number), plus aggregate stats including net insider flow in USD, buy count, sell count, and notable pattern flags for the requested window.","failureModes":["Invalid ticker format returns a 4xx error","Ticker not found in EDGAR returns empty transaction list or 404","days parameter out of range (>90 or <1) returns validation error","min_value_usd set too high filters out all transactions leaving empty results","SEC EDGAR upstream unavailability causes 5xx errors","Payment not received or insufficient USDC balance blocks the request"],"whenToPreferThis":"Use this endpoint when you need clean, pre-parsed insider transaction data from SEC Form 4 filings without building your own EDGAR parser — especially useful for investment research, pre-earnings conviction checks, or detecting unusual cluster buying/selling. Prefer this over raw EDGAR access when you need buy/sell/award classification, 10b5-1 flags, and aggregate net flow already computed. Good complement to fundamental and price data before major events.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:03:59.545Z","isFirstParty":false}