API Reference

REST API for Radar DaaS.

Base URL

https://radar.matchstick.trading

Authentication

API keys are issued from your account dashboard. Three methods are supported:

Query parameter (recommended for simple testing):

GET /api/events?api_key=YOUR_API_KEY&start=2026-01-01&end=2026-01-28

Authorization header:

Authorization: Bearer YOUR_API_KEY

X-API-Key header:

X-API-Key: YOUR_API_KEY

All methods are equivalent. Use headers for production integrations to avoid logging keys in URLs.

Demo Key

For testing, use the public demo key:

msr_demo_SfATJ8Tloemw8NGUZJyeFhVuiE8ieFRL

Demo key is rate-limited to 10 requests/minute. Get your own key from the account dashboard for higher limits.

Endpoints

GET /api/events

Retrieve historical events.

Parameters:

Parameter	Type	Required	Description
start	date	Yes	Start date
end	date	Yes	End date
issuer	string	No	Filter by issuer
transaction_code	string	No	Filter by code
limit	int	No	Max results (default: 100)

Response:

{
  "events": [...],
  "pagination": {
    "total": 1000,
    "limit": 100,
    "offset": 0,
    "has_more": true
  }
}

GET /api/downloads?file=events

Download full parquet file. Requires a signed-in web session and download credits (API key auth for downloads is not available yet).

GET /api/downloads?file=sample

Download free sample CSV. No auth required.

GET /api/system-status

Get system status and file metadata.

{
  "lastSync": "2026-01-28T19:21:09Z",
  "healthy": true
}

Rate Limits

Rate limits for /api/events vary by plan:

Plan	Limit
Demo	10 requests/minute
Free	100 requests/minute
Free Trial	200 requests/minute
Day Pass	300 requests/minute
Pro	600 requests/minute

Other endpoints:

Endpoint	Limit
/api/downloads	10/hour

Error Codes

Code	Description
400	Invalid parameters
401	Unauthorized
402	Insufficient credits
429	Rate limited

Roadmap

• API key access to downloads and file checksums

Request features in the discussions forum.