Events

Market events are the core data type in the Matchstick model.

Event Message

message Event {
  string id = 1;
  string event_type = 2;
  string issuer = 3;
  string cik = 4;
  google.protobuf.Timestamp filed_at = 5;
  google.protobuf.Timestamp captured_at = 6;
  float confidence = 7;
  google.protobuf.Struct metadata = 8;
}

Event Types

Type	Description
FORM_4	Insider trade disclosure
FILING_8K	Current report
FILING_10K	Annual report
NEWS	Financial news

Fields

id

Unique identifier: {source}:{type}:{hash}

Example: sec:form4:abc123

confidence

Data quality score (0.0-1.0):

Score	Meaning
1.0	Verified source
0.9+	High confidence
0.7-0.9	Medium confidence
<0.7	Review suggested

metadata

Event-specific fields as JSON struct. Varies by event type.

Example

{
  "id": "sec:form4:20250115",
  "event_type": "FORM_4",
  "issuer": "APPLE INC",
  "cik": "0000320193",
  "filed_at": "2025-01-15T14:30:00Z",
  "confidence": 0.98,
  "metadata": {
    "reporting_owner": "Tim Cook",
    "transaction_code": "S",
    "shares": 50000
  }
}