Sign in
latestOpenAPI 3.1.0Proprietary2026-08-16153976.7 KB

d6f73c217935

symbols

Form 4 event history and chart aggregates for one ticker

The complete per-ticker insider-trading payload behind alphai.io/stock/{ticker}/insider-trades: the paginated Form 4 event history plus everything a chart needs, in one request. One event is a filing's whole tranche group (shares summed, the price value-weighted, a 10b5-1 ladder is ONE event), same folding as the feed's insider block.

The first page (no cursor) also carries the aggregates: summary (3-month, 12-month and all-time windows plus the most active insiders of the last 12 months), series (monthly buckets) and series_weekly (Monday-keyed weekly buckets), both zero-filled up to the current period and capped to the trailing 12 months, and chart_events — every event of the trailing 12 months regardless of pagination. The aggregates always cover both sides regardless of the side filter, and they are null on cursor pages, which carry only the next events chunk.

Side semantics on this surface follow the value flow: code P is buy; codes S and D are both sell, because a code D sale back to the issuer moves dollars off the insider's position like any sale. This deliberately differs from the feed's insider.side, which labels D as other; use transaction_code to tell a market sale (S) from a sale to the issuer (D).

get/api/symbols/{ticker}/insider-trades/

Path parameters

tickerstring required

Accepts the same ticker forms as the symbol detail endpoint: bare crypto names resolve to their <SYM>-USD listing, and delisted or renamed symbols stay addressable. Crypto and foreign listings have no Form 4 flow, so they return empty history.

Query parameters

side'buy' | 'sell' | 'all'

Filters the paginated events list only; the first page's aggregates always cover both sides.

cursorstring

Opaque keyset cursor from a prior response's next_cursor. Omit it for the newest page, the only one carrying the aggregates.

page_sizeinteger

Events per page. Not tier-gated: every tier may request up to 200, so one request can load a chart's whole working set.

Response

One page of the event history. Empty arrays mean no recorded filings for a real listing; a ticker no symbol owns returns 404 instead.

tickerstring required
coverage_startstring date nullable

Earliest recorded transaction date for this ticker; charts should not claim history from before it. null when nothing is recorded.

next_cursorstring nullable required

Opaque cursor for the next (older) page; null at the end of the recorded history.

Example response

{
  "summary": {
    "last_3m": {
      "buy_value_usd": "1240000.00",
      "sell_value_usd": "224580213.05"
    },
    "last_12m": {
      "buy_value_usd": "1240000.00",
      "sell_value_usd": "224580213.05"
    },
    "all_time": {
      "buy_value_usd": "1240000.00",
      "sell_value_usd": "224580213.05"
    },
    "top_insiders": [
      {
        "name": "Intrator Michael N",
        "net_value_usd": "-505000000.00"
      }
    ]
  },
  "series": [
    {
      "month": "2026-08",
      "buy_value_usd": "0",
      "sell_value_usd": "48200000.00"
    }
  ],
  "series_weekly": [
    {
      "buy_value_usd": "0",
      "sell_value_usd": "9886021.65"
    }
  ],
  "chart_events": [
    {
      "transaction_code": "S",
      "security_title": "Common Stock",
      "shares": "107692",
      "avg_price_usd": "91.80",
      "total_value_usd": "9886021.65",
      "tranche_count": 8,
      "stake_change_pct": "-100.0",
      "insider_name": "Intrator Michael N",
      "insider_title": "CEO and President",
      "transaction_date": "2026-08-04",
      "filed_at": "2026-08-07T00:36:56Z"
    }
  ],
  "events": [
    {
      "transaction_code": "S",
      "security_title": "Common Stock",
      "shares": "107692",
      "avg_price_usd": "91.80",
      "total_value_usd": "9886021.65",
      "tranche_count": 8,
      "stake_change_pct": "-100.0",
      "insider_name": "Intrator Michael N",
      "insider_title": "CEO and President",
      "transaction_date": "2026-08-04",
      "filed_at": "2026-08-07T00:36:56Z"
    }
  ]
}