Skip to main content
GET
/
api
/
v1
/
stock
/
{symbol}
/
insider-transactions
Insider Transactions
curl --request GET \
  --url https://stocks-dev.up.railway.app/api/v1/stock/{symbol}/insider-transactions
{
  "symbol": "<string>",
  "company_name": "<string>",
  "insider_transactions": [
    {
      "insider": "<string>",
      "relation": "<string>",
      "transaction": "<string>",
      "cost": 123,
      "shares": 123,
      "value": 123,
      "shares_owned_following": 123
    }
  ],
  "total_transactions": 123,
  "timestamp": "<string>",
  "source": "<string>"
}

​
Overview

Retrieve recent insider trading transactions for any publicly traded company. This endpoint provides information about stock purchases, sales, and other transactions by company insiders including executives, directors, and large shareholders.
This endpoint uses YFinance data. Insider trading data helps investors understand sentiment and potential future performance based on insider activity.

​
Parameters

​
symbol
string
required
Stock ticker symbol (e.g., AAPL, MSFT, GOOGL, TSLA)

​
Response

​
symbol
string
The stock ticker symbol
​
company_name
string
Full company name
​
insider_transactions
array
Array of recent insider transactions
​
total_transactions
number
Total number of transactions returned
​
timestamp
string
ISO timestamp of the response
​
source
string
Data source identifier (“YFinance”)

​
Examples

curl "https://stocks-dev.up.railway.app/api/v1/stock/AAPL/insider-transactions"

​
Response Example

{
  "symbol": "AAPL",
  "company_name": "Apple Inc.",
  "insider_transactions": [
    {
      "insider": "Timothy D Cook",
      "relation": "CEO",
      "transaction": "Sale",
      "cost": 189.84,
      "shares": 511000,
      "value": 97049440,
      "shares_owned_following": 3204462
    },
    {
      "insider": "Katherine L Adams", 
      "relation": "Senior Vice President",
      "transaction": "Sale",
      "cost": 186.74,
      "shares": 25000,
      "value": 4668500,
      "shares_owned_following": 427334
    },
    {
      "insider": "Luca Maestri",
      "relation": "Chief Financial Officer", 
      "transaction": "Sale",
      "cost": 185.73,
      "shares": 96735,
      "value": 17969528,
      "shares_owned_following": 110673
    }
  ],
  "total_transactions": 10,
  "timestamp": "2025-06-28T19:30:15.123456",
  "source": "YFinance"
}

​
Use Cases

  • Insider Sentiment: Large sales by executives may indicate overvaluation
  • Confidence Signals: Insider purchases often signal confidence in company prospects
  • Timing Analysis: Track patterns in insider trading around earnings or events
  • Executive Behavior: Monitor if leadership is reducing their holdings
  • Diversification: Understand if sales are for portfolio diversification
  • Regulatory Compliance: Track required disclosures and filings
  • Industry Trends: Compare insider activity across sector competitors
  • Compensation Analysis: Understand stock-based compensation patterns
  • Corporate Governance: Monitor director and officer trading patterns

​
Error Responses

{
  "error": "Failed to fetch insider transactions for INVALID"
}

{
  "symbol": "NEWCO",
  "company_name": "New Company Inc.",
  "insider_transactions": "No insider transaction data available",
  "timestamp": "2025-06-28T19:30:15.123456",
  "source": "YFinance"
}

{
  "error": "Rate limit exceeded",
  "detail": "YFinance rate limited. Please try again later.",
  "retry_after": 60
}

​
Important Notes

Data Limitations: Insider trading data depends on SEC filings and may have delays. Not all transactions may be immediately available.
Regulatory Context: Insider transactions are regulated by the SEC and must be reported within specific timeframes. This data reflects publicly disclosed transactions only.
Analysis Tips:
  • Focus on patterns rather than individual transactions
  • Consider the insider’s role and typical trading behavior
  • Look at transaction timing relative to company events

​
MCP Protocol Usage

For AI agents using the Model Context Protocol: 
{
  "method": "tools/call",
  "params": {
    "name": "get_insider_transactions",
    "arguments": {
      "symbol": "AAPL"
    }
  }
}

Stock Quote

Get current stock price and market data

Company Overview

Get comprehensive company information

Analyst Recommendations

Get analyst buy/sell recommendations

Government Trades

Track Congressional and Senate trading activity