Developer API

Public read-only JSON endpoints. No API key needed. CORS is enabled. Rate-limited to 30 requests/minute per IP. Cached 10 minutes at the CDN.

Authentication

None. Public data. If you need higher limits or commercial SLA, email george@insidereu.com.

Endpoints

Leaderboard

GET /api/v1/leaderboard?sort=win_rate&limit=20
GET /api/v1/leaderboard?sort=active&limit=50

Response:
{
  "sort": "win_rate",
  "rows": [
    {
      "insider_id": "klaus-muller__sap-se",
      "insider_name": "Klaus Müller",
      "most_recent_company": "SAP SE",
      "most_recent_role": "CFO",
      "win_rate_3m": 0.78,
      "avg_return_3m": 0.12,
      "buys_with_price_data": 7,
      "last_buy_at": "2026-03-14"
    }
  ]
}

Insider profile

GET /api/v1/insider/{id}

Response:
{
  "insider": {
    "id": "klaus-muller__sap-se",
    "name": "Klaus Müller",
    "role": "CFO",
    "country": "DE",
    "companies": ["SAP SE"]
  },
  "stats": {
    "total_filings": 12,
    "buys": 8,
    "sells": 4,
    "total_buy_eur": 5420000,
    "total_sell_eur": 1800000,
    "net_flow_eur": 3620000
  },
  "filings": [
    {
      "id": "...",
      "date": "2026-03-14",
      "type": "buy",
      "company": "SAP SE",
      "isin": "DE0007164600",
      "shares": 1500,
      "price": 148.20,
      "value_eur": 222300,
      "exchange": "XETRA"
    }
  ]
}

Company profile

GET /api/v1/company/{isin}

Response: same shape as insider, but stats include distinct_insiders count.

Recent buys (Atom)

GET /feed.xml

Standard Atom 1.0 feed. Works in any RSS reader.

Service health

GET /api/health

Returns 200 if green, 503 if the last scrape is > 36h old or failed.
Point your uptime monitor (UptimeRobot, BetterStack) at this URL.

Rate limits

  • 30 requests / minute / IP on all v1 endpoints.
  • 429 responses include Retry-After header.

Stability

The v1 prefix is a soft promise of compatibility. Additive changes (new fields, new endpoints) will not be considered breaking. Removed fields or schema changes would ship under v2.

What's not public (yet)

  • Full per-insider 3m/12m forward return arrays — paid-tier only.
  • Bulk filings endpoint without filters — see Enterprise.
  • Historical leaderboard snapshots.

Enterprise

Need higher rate limits, no-cache access, a private feed of your competitors' insider activity, or Pan-Euronext detail pulls? Email george@insidereu.com.