> ## Documentation Index > Fetch the complete documentation index at: https://tradewatch.io/docs/llms.txt > Use this file to discover all available pages before exploring further. # Insider Trades > Returns insider trading activity sourced from SEC EDGAR Form 4 filings. Each record represents a single transaction by a company insider (officers, directors, and beneficial owners of 10%+ stock). Transaction type codes: P=Purchase, S=Sale, G=Gift, A=Conversion, F=Payment of exercise price, etc. Results are ordered by `filing_date` descending. ## OpenAPI ````yaml /openapi.json get /stocks/insider-trades openapi: 3.1.0 info: title: tradewatch.io version: 3.1.0 description: Financial market data for Developers servers: - url: https://api.tradewatch.io description: Production API server security: - API Key: [] tags: - name: Account description: >- In this section, you can find methods that can be helpful to manage your API account. x-displayName: Account - name: Currencies description: >- In this section, you can find methods that can be helpful to retrieve data for traditional currencies (Forex). x-displayName: Currencies - name: Crypto description: >- In this section, you can find methods that can be helpful to retrieve data for cryptocurrencies. x-displayName: Crypto - name: Indices description: >- In this section, you can find methods that can be helpful to retrieve data for market indices. x-displayName: Indices - name: Stocks description: >- In this section, you can find methods that can be helpful to retrieve data for stocks and equities. x-displayName: Stocks - name: Fundamentals description: Financial statements and company data sourced from SEC EDGAR filings. - name: Markets description: Stock exchange and market session information. - name: Commodities description: >- In this section, you can find methods that can be helpful to retrieve data for commodities. x-displayName: Commodities paths: /stocks/insider-trades: get: tags: - Fundamentals summary: Insider Trades description: >- Returns insider trading activity sourced from SEC EDGAR Form 4 filings. Each record represents a single transaction by a company insider (officers, directors, and beneficial owners of 10%+ stock). Transaction type codes: P=Purchase, S=Sale, G=Gift, A=Conversion, F=Payment of exercise price, etc. Results are ordered by `filing_date` descending. operationId: list_insider_trades_insider_trades_get parameters: - name: ticker in: query required: true schema: type: string description: Stock ticker symbol (e.g. AAPL) title: Ticker description: Stock ticker symbol (e.g. AAPL) - name: limit in: query required: false schema: anyOf: - type: integer maximum: 100 minimum: 1 - type: 'null' description: Maximum number of records to return (1–100) title: Limit description: Maximum number of records to return (1–100) - name: filing_date_gte in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: 'Filter: filing_date >= this date (YYYY-MM-DD)' title: Filing Date Gte description: 'Filter: filing_date >= this date (YYYY-MM-DD)' - name: filing_date_lte in: query required: false schema: anyOf: - type: string format: date - type: 'null' description: 'Filter: filing_date <= this date (YYYY-MM-DD)' title: Filing Date Lte description: 'Filter: filing_date <= this date (YYYY-MM-DD)' - name: transaction_type in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by transaction type code (e.g. P for purchase, S for sale) title: Transaction Type description: Filter by transaction type code (e.g. P for purchase, S for sale) responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/InsiderTradesResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: InsiderTradesResponse: properties: ticker: type: string title: Ticker description: Stock ticker symbol (uppercase) insider_trades: items: $ref: '#/components/schemas/InsiderTradeItem' type: array title: Insider Trades description: List of insider trade records ordered by filing date descending type: object required: - ticker - insider_trades title: InsiderTradesResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError InsiderTradeItem: properties: ticker: type: string title: Ticker description: Stock ticker symbol (uppercase) insider_name: type: string title: Insider Name description: Name of the insider (reporting owner) transaction_date: type: string format: date title: Transaction Date description: Date of the transaction (YYYY-MM-DD) filing_date: type: string format: date title: Filing Date description: Date the Form 4 was filed with the SEC (YYYY-MM-DD) transaction_type: type: string title: Transaction Type description: 'Transaction type code: P (purchase), S (sale), G (gift), etc.' securities_owned: anyOf: - type: number - type: 'null' title: Securities Owned description: Total securities owned by the insider after the transaction shares_transaction: anyOf: - type: number - type: 'null' title: Shares Transaction description: Number of shares involved in the transaction price_per_share: anyOf: - type: number - type: 'null' title: Price Per Share description: Price per share at time of transaction (USD) transaction_value: anyOf: - type: number - type: 'null' title: Transaction Value description: Total value of the transaction (USD); computed as shares × price type: object required: - ticker - insider_name - transaction_date - filing_date - transaction_type title: InsiderTradeItem ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: API Key: description: Authentication via API key header type: apiKey name: api-key in: header ````