Felo API PlatformFelo API Platform

Data API / Financial Data / Insider Trades

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.

Parameters

query

  • tickerstringRequired

    The ticker symbol of the company.

  • limitintegerOptional

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

  • namestringOptional

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

  • transaction_typestringOptional

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

  • filing_datestringOptional

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

  • filing_date_gtestringOptional

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

  • filing_date_ltestringOptional

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

  • filing_date_gtstringOptional

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

  • filing_date_ltstringOptional

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

Example request

curl -G "https://openapi.felo.ai/v1/beta/financial/insider-trades" \
  --data-urlencode "ticker=<string>" \
  -H "Authorization: Bearer $FELO_API_KEY"

Response

Response fields

  • insider_tradesobject[]Optional
  • tickerstringOptional

    The ticker symbol of the company.

  • issuerstringOptional

    The name of the issuing company.

  • namestringOptional

    The name of the insider.

  • titlestringOptional

    The title of the insider.

  • is_board_directorbooleanOptional

    Whether the insider is a board director.

  • transaction_datestringOptional

    The date of the transaction.

  • transaction_sharesnumberOptional

    The number of shares involved in the transaction.

  • transaction_price_per_sharenumberOptional

    The price per share in the transaction.

  • transaction_valuenumberOptional

    The total value of the transaction.

  • shares_owned_before_transactionnumberOptional

    The number of shares owned before the transaction.

  • shares_owned_after_transactionnumberOptional

    The number of shares owned after the transaction.

  • security_titlestringOptional

    The title of the security involved in the transaction.

  • filing_datestringOptional

    The date the transaction was filed.