GET /api/v1/us/insider-trades

Returns insider trading transactions reported to the SEC.

Request

GET /api/v1/us/insider-trades

Headers

Header	Value
F-API-KEY	Your API key

Query Parameters

Parameter	Type	Required	Filter	Description
cik	string	No	exact	SEC CIK
ticker	string	No	exact	Stock ticker
insider_name	string	No	exact	Insider name
transaction_type	string	No	exact	Transaction type
transaction_code	string	No	exact	Transaction code
accession_number	string	No	exact	Accession number
date_from	string	No	range	Start date
date_to	string	No	range	End date
limit	integer	No	—	Max rows per page (default 100, max 1000)
offset	integer	No	—	Rows to skip (default 0)
sort	string	No	—	Sort field (default transaction_date)
order	asc | desc	No	—	Sort direction (default desc)

Example

curl -H "F-API-KEY: fk-xxxxx" \
  "https://finance-api.xp-java.workers.dev/api/v1/us/insider-trades?ticker=AAPL&date_from=2024-01-01&date_to=2024-12-31"

Response

{
  "code": 0,
  "message": "ok",
  "data": [
    {
      "cik": "0000320193",
      "ticker": "AAPL",
      "filing_type": "4",
      "filing_date": "2024-10-15",
      "accession_number": "0000320193-24-000456",
      "url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000456/0000320193-24-000456-index.htm",
      "insider_name": "TIMOTHY D COOK",
      "insider_title": "Chief Executive Officer",
      "transaction_date": "2024-10-01",
      "transaction_type": "Sale",
      "transaction_code": "S",
      "description": "Common Stock",
      "shares": 50000,
      "price_per_share": 225.5,
      "total_value": 11275000,
      "remaining_shares": 3000000,
      "updated_at": "2024-10-15T00:00:00Z"
    }
  ],
  "meta": {
    "total": 25,
    "limit": 100,
    "offset": 0,
    "has_more": false
  }
}