API Reference

REST API for Radar DaaS.

Base URL

https://radar.matchstick.trading

Authentication

Authorization: Bearer YOUR_API_KEY

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/events.parquet

Download full parquet file. Requires authentication.

GET /api/downloads/events_sample.csv

Download free sample CSV. No auth required.

GET /api/system-status

Get system status and file metadata.

{
  "status": "healthy",
  "last_sync": "2025-01-15T12:00:00Z",
  "files": {
    "events_parquet": {
      "size_bytes": 156789012,
      "row_count": 125000
    }
  }
}

Rate Limits

Endpoint	Limit
/api/events	100/minute
/api/downloads/*	10/hour

Error Codes

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