{"openapi":"3.0.3","info":{"title":"Gnist Context — Insider Trading","description":"Corporate insider buy/sell transactions — Form 4 filings parsed for officer, director, and 10%+ owner trades.\n\n- **MCP endpoint:** `https://context.gnist.ai/mcp/insider-trading/`\n- **Toolkit page:** `/toolkits/insider-trading`\n- **Full API spec:** `/api/openapi.json`\n- **Get an API key:** `/signup`","version":"1.0.0","contact":{"name":"GnistAI","url":"https://gnist.ai"}},"servers":[{"url":"https://context.gnist.ai","description":"Production"}],"paths":{"/rest/insider-trading/get_insider_trades":{"post":{"tags":["Finance"],"summary":"get_insider_trades","description":"Get recent insider buy/sell transactions for a public company.\n\nParses SEC Form 4 filings to extract individual transactions by\ncorporate insiders (officers, directors, 10%+ owners). Shows who\ntraded, what they traded, how many shares, at what price, and\ntheir remaining holdings.\n\nTransaction codes:\n- P = Purchase (open market buy)\n- S = Sale (open market sell)\n- M = Exercise/conversion of derivative (e.g. stock option)\n- A = Grant/award\n- F = Tax withholding\n\nExamples:\n    get_insider_trades(\"AAPL\") → Recent Apple insider transactions\n    get_insider_trades(\"TSLA\", limit=10) → Last 10 Tesla Form 4 filings\n\nReturns:\n    Company info and list of transactions sorted by date (newest first),\n    each with owner details, shares, price, and post-transaction holdings.","operationId":"insider_trading_get_insider_trades","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ticker_or_cik":{"description":"Ticker symbol (e.g. \"AAPL\", \"TSLA\") or numeric CIK (e.g. \"320193\").","type":"string"},"limit":{"default":20,"description":"Maximum Form 4 filings to parse (default 20, max 50). Each filing may contain multiple transactions.","type":"integer"}},"required":["ticker_or_cik"],"type":"object"}}}}}},"/rest/insider-trading/get_insider_summary":{"post":{"tags":["Finance"],"summary":"get_insider_summary","description":"Get aggregated insider trading activity for a company.\n\nAnalyzes recent Form 4 filings and summarizes:\n- Net buying vs selling sentiment (are insiders buying or selling?)\n- Total shares bought and sold across all insiders\n- Per-insider breakdown: name, title, shares bought/sold, net position\n\nUseful for gauging insider confidence in a company's prospects.\nHeavy insider buying often signals management confidence; heavy\nselling may indicate concern (though selling for diversification\nor tax reasons is common).\n\nExamples:\n    get_insider_summary(\"AAPL\") → Apple insider buy/sell summary\n    get_insider_summary(\"NVDA\") → NVIDIA insider activity overview\n\nReturns:\n    Overall buy/sell sentiment, total shares bought and sold,\n    and per-insider summary with relationship and activity.","operationId":"insider_trading_get_insider_summary","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ticker_or_cik":{"description":"Ticker symbol (e.g. \"AAPL\") or numeric CIK (e.g. \"320193\").","type":"string"}},"required":["ticker_or_cik"],"type":"object"}}}}}},"/rest/insider-trading/report_feedback":{"post":{"tags":["Finance"],"summary":"report_feedback","description":"Report a bug, feature request, or general feedback for this data source.\n\nUse this when something doesn't work as expected, when you'd like\na new feature, or when you have suggestions for improvement.\n\nArgs:\n    feedback: Describe the issue or suggestion.\n    feedback_type: One of 'bug', 'feature_request', or 'general'.","operationId":"insider_trading_report_feedback","responses":{"200":{"description":"Successful tool call","content":{"application/json":{"schema":{"type":"object"}}}},"404":{"description":"Server or tool not found"},"500":{"description":"Tool execution error"}},"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"feedback":{"type":"string"},"feedback_type":{"default":"general","type":"string"}},"required":["feedback"],"type":"object"}}}}}}},"tags":[{"name":"Finance","description":"Data sources: Finance"}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"gnist-api-key","description":"API key passed via request header."},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"gnist_api_key","description":"API key passed via query parameter."}}}}