Event Types

Reference for all event types emitted by the Events API.

Form 4 (Insider Trade)

SEC Form 4 insider trading disclosures.

{
  "eventType": "FORM_4",
  "issuer": "NVIDIA CORP",
  "cik": "0001045810",
  "filedAt": "2025-01-15T16:00:00Z",
  "confidence": 0.98,
  "metadata": {
    "reportingOwner": "Jensen Huang",
    "relationship": "CEO",
    "transactionCode": "P",
    "shares": 50000,
    "pricePerShare": 125.00,
    "totalValue": 6250000,
    "directOwnership": true,
    "secUrl": "https://www.sec.gov/cgi-bin/browse-edgar..."
  }
}

Transaction Codes

Code	Description
P	Open market purchase
S	Open market sale
A	Grant or award
M	Exercise of derivative
G	Gift
D	Disposition (non-sale)

SEC Filing

General SEC filing notifications (8-K, 10-K, 10-Q).

{
  "eventType": "FILING",
  "issuer": "TESLA INC",
  "cik": "0001318605",
  "filedAt": "2025-01-15T08:00:00Z",
  "confidence": 1.0,
  "metadata": {
    "formType": "8-K",
    "description": "Current report",
    "items": ["Item 2.02", "Item 9.01"],
    "secUrl": "https://www.sec.gov/Archives/edgar/data/..."
  }
}

Form Types

Form	Description
8-K	Current report (material events)
10-K	Annual report
10-Q	Quarterly report
4	Statement of changes in beneficial ownership

News

Financial news from RSS feeds.

{
  "eventType": "NEWS",
  "issuer": "MICROSOFT CORP",
  "cik": null,
  "filedAt": "2025-01-15T12:30:00Z",
  "confidence": 0.85,
  "metadata": {
    "headline": "Microsoft announces Q4 earnings beat",
    "source": "Reuters",
    "url": "https://reuters.com/..."
  }
}

Heartbeat

Keep-alive messages sent every 30 seconds:

{
  "eventType": "HEARTBEAT",
  "timestamp": "2025-01-15T12:30:30Z"
}

Used to detect connection health. If no heartbeat is received within 60 seconds, the client should reconnect.