Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Get insider trades

Felo API Support
MIT
Server:https://openapi.felo.ai
Client Libraries
Shell Curl

Financial Data

​

Company fundamentals, financial statements, market prices and economic data.

Financial Data Operations

Get insider trades

​

Form 4 insider transactions for one stock. Each row carries the person (name, title, is_board_director), the trade (transaction_date, transaction_code, transaction_type, transaction_shares, transaction_price_per_share, transaction_value), the resulting position (shares_owned_before_transaction, shares_owned_after_transaction) and the filing (form_type, filing_date, security_title). ticker is required. Filter with name or transaction_type, and bound by filing date with filing_date, filing_date_gte, filing_date_lte, filing_date_gt or filing_date_lt. Use it for who inside the company bought or sold and when.

Query Parameters
  • ticker
    Type: string
    required

    The ticker symbol of the company.

  • limit
    Type: integer

    The maximum number of transactions to return (default: 10).

  • name
    Type: string

    Filter by insider name (e.g., 'Jen Hsun Huang'). Use the /insider-trades/names endpoint to get available names for a ticker.

  • transaction_type
    Type: string

    Filter by transaction type (e.g., 'Open market sale', 'Gift'). Use the /insider-trades/transaction-types endpoint to get available types.

  • filing_date
    Type: string Format: date

    Filter by exact filing date in YYYY-MM-DD format.

  • filing_date_gte
    Type: string Format: date

    Filter by filing date greater than or equal to this date (YYYY-MM-DD).

  • filing_date_lte
    Type: string Format: date

    Filter by filing date less than or equal to this date (YYYY-MM-DD).

  • filing_date_gt
    Type: string Format: date

    Filter by filing date greater than this date (YYYY-MM-DD).

  • filing_date_lt
    Type: string Format: date

    Filter by filing date less than this date (YYYY-MM-DD).

Responses
  • 200
    Type: object · InsiderTradesResponse

    Insider trades response

    • insider_trades
      Type: array object[] · InsiderTrade[]
      • filing_date
        Type: string Format: date

        The date the transaction was filed.

      • is_board_director
        Type: boolean

        Whether the insider is a board director.

      • issuer
        Type: string

        The name of the issuing company.

      • name
        Type: string

        The name of the insider.

      • security_title
        Type: string

        The title of the security involved in the transaction.

      • shares_owned_after_transaction
        Type: number

        The number of shares owned after the transaction.

      • shares_owned_before_transaction
        Type: number

        The number of shares owned before the transaction.

      • ticker
        Type: string

        The ticker symbol of the company.

      • title
        Type: string

        The title of the insider.

      • transaction_date
        Type: string Format: date

        The date of the transaction.

      • transaction_price_per_share
        Type: number

        The price per share in the transaction.

      • transaction_shares
        Type: number

        The number of shares involved in the transaction.

      • transaction_value
        Type: number

        The total value of the transaction.

    application/json
  • 400
    Type: object · ErrorResponse

    Bad request

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 401
    Type: object · ErrorResponse

    Unauthorized

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 402
    Type: object · ErrorResponse

    The request requires a paid subscription

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 403

    The account is not permitted to perform this operation.

  • 404
    Type: object · ErrorResponse

    The specified resource was not found

    • error
      Type: string

      A short error message.

    • message
      Type: string

      A more detailed error message.

    application/json
  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

Request Example for get/v1/beta/financial/insider-trades
curl 'https://openapi.felo.ai/v1/beta/financial/insider-trades?ticker=' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "insider_trades": [
    {
      "ticker": "string",
      "issuer": "string",
      "name": "string",
      "title": "string",
      "is_board_director": true,
      "transaction_date": "2026-09-30",
      "transaction_shares": 1,
      "transaction_price_per_share": 1,
      "transaction_value": 1,
      "shares_owned_before_transaction": 1,
      "shares_owned_after_transaction": 1,
      "security_title": "string",
      "filing_date": "2026-09-30"
    }
  ]
}

Insider trades response

Get insider trades