Developer_Docs // v1.0.0

SYSTEM_ARCHITECTURE
& CORE MISSION.

Eliminating Asymmetry

The financial markets suffer from a structural information asymmetry. Corporate insiders—CEOs, CFOs, and board members—possess asymmetric knowledge regarding their companies' operational health and future valuations.

At WHALE_INSIDER_DATA, our core directive is to democratize this information. We run a high-frequency parsing engine that monitors the SEC EDGAR network. The moment a Form 4 is filed, our systems ingest, clean, and normalize the transaction data.

This API is designed for quantitative analysts, algorithmic traders, and financial researchers who need programmatic, low-latency access to C-Suite capital flows, enabling the integration of executive sentiment into broader risk assessment models.

Authentication

Our infrastructure is protected and routed exclusively through the RapidAPI network to ensure high availability and rate limiting. All requests must include your RapidAPI proxy secret in the headers. Direct IP access is restricted.

Headers:
"x-rapidapi-proxy-secret": "YOUR_API_KEY_HERE"

REST_Endpoints

Global Live Feed

Retrieve the most recent insider transactions across the entire market.

GET/api/v1/transactions/latest
Query Params: ?limit=50 (Max: 1000)

Ticker Lookup

Filter transactions by a specific company ticker symbol (e.g., AAPL).

GET/api/v1/transactions/ticker/:symbol

Executive Search

Fuzzy search across the database for specific executives or board members.

GET/api/v1/transactions/executive
Required Param: ?name=Elon Musk

The "Whales" Tracker

Retrieve the largest single transactions by nominal USD value within a timeframe.

GET/api/v1/transactions/whales
Optional Param: ?days=30 (Default: 30)

Analytics Summary

Aggregated mathematical summary (Total Shares, Total Dollars) grouped by transaction type.

GET/api/v1/analytics/summary/:symbol

Date Range Query

Extract historical records bounded by specific ISO 8601 calendar dates.

GET/api/v1/transactions/daterange
Required: ?start=YYYY-MM-DD&end=YYYY-MM-DD

Response_Schema

// Example JSON Response for /api/v1/transactions/latest{
  "count": 50,
  "limit_applied": 50,
  "data": [
    {
      "id": 447997,
      "Form": "Form 4",
      "Ticker": "UHS",
      "Executive": "SUSSMAN ELLIOT J MD MBA",
      "Position": "Director",
      "Date": "2026-03-13",
      "Type": "S",
      "Shares": 356,
      "Price": 193.3742,
      "Total_Value": 68841.22
    }
  ]
}