Data Downloads

Download and work with Radar data files.

Available Files

File	Description	Format	Size
events.parquet	Full event data	Parquet	~150 MB
events_index.parquet	Lightweight index	Parquet	~15 MB
events_sample.csv	Free sample	CSV	~1 MB

Download Methods

1. Web Dashboard

The easiest way to download data:

1. Go to radar.matchstick.trading
2. Sign in with your account
3. Navigate to Events > Raw Data Access
4. Click Download Parquet or Download Index

2. REST API

Using curl with authentication:

# Download events.parquet
curl -o events.parquet \
  "https://radar.matchstick.trading/api/downloads?file=events"

# Download index
curl -o events_index.parquet \
  "https://radar.matchstick.trading/api/downloads?file=index"

Note: parquet downloads require a signed-in session and download credits. API key access to downloads is on the roadmap.

Free Sample

A free sample CSV is available without authentication:

curl -o events_sample.csv \
  "https://radar.matchstick.trading/api/downloads?file=sample"

Sample contents (~1000 recent events):

source_fingerprint,schema_id,decoder_version,sequence_id,capture_time,instrument_id,exchange_time,title,description,url,data_quality_score,tags
sec_insider,sec_filing_form_4,v0.0.1,urn:tag:sec.gov,2008:accession-number=...,2026-01-24T00:47:17,0001652044,2026-01-24T00:47:17,4 - Alphabet Inc. (0001652044) (Issuer),<b>Filed:</b> 2026-01-23 <b>AccNo:</b> ...,https://www.sec.gov/Archives/...,100,"[\"insider_trading\",\"form_4\"]"
...

Data Freshness

Data is updated on a schedule:

File	Update Frequency
events.parquet	Every 6 hours
events_index.parquet	Every 6 hours
events_sample.csv	Daily

Check the last update time via the API:

curl "https://radar.matchstick.trading/api/system-status" | jq '.lastSync'

Incremental Updates

For incremental updates, use the REST API with date parameters:

# Using demo key (10 req/min limit)
curl "https://radar.matchstick.trading/api/events?start=2026-01-08&end=2026-01-15&api_key=msr_demo_SfATJ8Tloemw8NGUZJyeFhVuiE8ieFRL"

# Using your own key (higher limits)
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://radar.matchstick.trading/api/events?start=2026-01-08&end=2026-01-15"

Verification

Verify file integrity using checksums:

# Get checksum from API
curl "https://radar.matchstick.trading/api/system-status"

# Verify local file
sha256sum events.parquet

Checksums and file metadata are on the roadmap. Request them in the discussions forum.

Storage Recommendations

For production use:

1. Store locally - Keep a local copy for fast access
2. Automate updates - Use a script to poll the API for new data
3. Version files - Keep historical snapshots for reproducibility
4. Verify checksums - Always verify after download