v1

latestOpenAPI 3.0.02026-07-266091181.5 KB

Insider Transaction

Insider Transactions

Returns insider transaction data from SEC Form 4 filings. Use /filings endpoint for grouped filing view (transactions nested under each filing) or /transactions endpoint for flattened individual transaction view. Both endpoints support the same query parameters.

get/api/v1/sec/insider_transactions/{view_type}

Path parameters

view_type'filings' | 'transactions' required

Response format: 'filings' returns grouped filing view with transactions nested, 'transactions' returns flattened individual transaction view

Query parameters

pageinteger

Page offset. For optimization, performance and technical reasons, page offsets are limited from 0 - 100000. Limit the query results by other parameters such as date. Default is 0

pagesizeinteger

Number of results returned. Limit 1000

date_fromstring date

Start date in YYYY-MM-DD format

date_tostring date

End date in YYYY-MM-DD format

updated_sinceinteger

Records last Updated Unix timestamp (UTC). This will force the sort order to be Greater Than or Equal to the timestamp indicated

datestring date

Date in YYYY-MM-DD format

chamber'House' | 'Senate'

Chamber

fieldsstring

Fields

search_keys_type'symbol' | 'accession_number' | 'cik' | 'id'

Search keys type

search_keysstring

Search keys

display'flat' | 'nested'

Display

Response

Insider Transaction data. Response structure varies by endpoint: /filings returns nested filing data, /transactions returns flattened transaction data

Example response

{
  "data": [
    {
      "accession_number": "0001127602-24-000123",
      "company_name": "Apple Inc.",
      "company_symbol": "AAPL",
      "filing_date": "2024-01-09T00:00:00Z",
      "footnotes": [
        {
          "id": "F1",
          "text": "Shares were sold pursuant to a Rule 10b5-1 trading plan"
        }
      ],
      "form_type": "4",
      "html_url": "https://www.sec.gov/cgi-bin/browse-edgar?action=getcompany&CIK=0000320193",
      "id": "64a1b2c3d4e5f6789012345",
      "is_10b5": true,
      "owner": {
        "insider_cik": "0001234567",
        "insider_name": "Tim Cook",
        "insider_title": "Chief Executive Officer",
        "is_director": true,
        "is_officer": true,
        "raw_signature": "/s/ Tim Cook"
      },
      "remaining_shares": "125000",
      "remaining_underlying_shares": "50000",
      "traded_percentage": "15.5",
      "transactions": [
        {
          "acquired_or_disposed": "D",
          "conversion_exercise_price_derivative": "150.25",
          "date_deemed_execution": "2024-01-09T00:00:00Z",
          "date_exercisable": "2024-01-09T00:00:00Z",
          "date_expiration": "2025-01-09T00:00:00Z",
          "date_transaction": "2024-01-09T00:00:00Z",
          "ownership": "Direct",
          "post_transaction_quantity": "250000",
          "price_per_share": "150.25",
          "remaining_underlying_shares": "50000",
          "security_title": "Common Stock",
          "shares": "10000",
          "transaction_code": "S",
          "transaction_id": "TXN-20240109-001",
          "underlying_security_title": "Common Stock",
          "underlying_shares": "10000"
        }
      ],
      "updated": 1704758400
    }
  ]
}