Events API

Market event streaming application with near real-time SSE feeds for EDGAR filings and insider trade data.

Overview

The Events API provides Server-Sent Events (SSE) streaming for:

• Form 4 Insider Trades: Near real-time insider trading alerts from SEC EDGAR
• SEC Filings: 8-K, 10-K, 10-Q, and other EDGAR submissions
• RSS News: Financial news from configured feeds

Architecture

events.matchstick.trading
         ↓
   Vercel (static frontend)
         ↓ SSE connections
   Fly.io (Node.js backend)
         ↓ fetches from
   Radar API (historical data)

Quick Start

Connect to the SSE stream:

const eventSource = new EventSource('https://events.matchstick.trading/api/stream');

eventSource.onmessage = (event) => {
  const data = JSON.parse(event.data);
  console.log('Received event:', data);
};

eventSource.onerror = (error) => {
  console.error('SSE error:', error);
};

Deployments

Component	URL	Platform
Frontend	https://events.matchstick.trading	Vercel
Backend API	https://matchstick-events-api.fly.dev	Fly.io

Live Demo

Try the live demo at events.matchstick.trading.

Features

• Near real-time streaming: SSE-based event delivery
• Multiple event types: Form 4 trades, SEC filings, news
• Filtering: Filter by event type, issuer, or date range
• Reconnection: Automatic reconnection with event ID resumption
• Parquet integration: Load historical data from Radar exports

Next Steps

• Quickstart Guide - Get up and running
• Event Types - Understand event schemas
• Client Integration - Framework-specific guides