Quick Start

60-second integration to normalized SEC Form 4 insider trading data.

System Overview

Welcome to the NexusForm4 API. This service provides low-latency, programmatic access to normalized SEC Form 4 insider trading data, updated every 6 hours directly from SEC EDGAR, delivered into your quantitative infrastructure as clean, predictable JSON.

The NexusForm4 API eliminates the structural overhead of tracking regulatory filings yourself — parsing SGML submissions, handling EDGAR's per-day index format, and normalizing inconsistent filer XML — so every endpoint returns ready-to-use structured data instead of raw filings.

Market Coverage

Comprehensive tracking across all SEC-reporting companies whose officers, directors, and 10%+ owners are required to file under Section 16 of the Securities Exchange Act — regardless of listing exchange or venue. Coverage is determined by SEC filing requirements, not by specific exchange partnerships.

Authentication

The API uses a secure, gateway-enforced header for authentication. All requests are authenticated automatically via the RapidAPI Proxy layer using your standard marketplace key — no separate signup, token provisioning, or key management required beyond your RapidAPI account.

All requests must contain the following headers:

HTTP
X-RapidAPI-Key: YOUR_API_KEY_HERE
X-RapidAPI-Host: nexusform4-sec-insider-trading-c-suite-signals.p.rapidapi.com
All endpoints are served through the RapidAPI gateway; the backend's direct hostname is not intended for public use and will reject requests that don't carry a valid RapidAPI proxy signature.

Quick Start (60-Second Integration)

Follow these three steps to pull your first production payload.

Step 1: Secure an Access Key

Navigate to the Pricing tab on our RapidAPI marketplace listing. Subscribe to a tier that matches your monthly request volume. Your API key generates instantly.

Step 2: Construct the Request

Execute an authenticated GET call to the ticker endpoint.

Python
import requests

url = "https://nexusform4-sec-insider-trading-c-suite-signals.p.rapidapi.com/trades/AAPL"
headers = {
    "X-RapidAPI-Key": "YOUR_API_KEY_HERE",
    "X-RapidAPI-Host": "nexusform4-sec-insider-trading-c-suite-signals.p.rapidapi.com"
}
response = requests.get(url, headers=headers)
data = response.json()
print(data)
JavaScript
const url = 'https://nexusform4-sec-insider-trading-c-suite-signals.p.rapidapi.com/trades/AAPL';
const options = {
  method: 'GET',
  headers: {
    'X-RapidAPI-Key': 'YOUR_API_KEY_HERE',
    'X-RapidAPI-Host': 'nexusform4-sec-insider-trading-c-suite-signals.p.rapidapi.com'
  }
};
fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error('Error:', err));

Step 3: Parse the Output

The API responds with standard HTTP status codes and a structured JSON array. Each transaction object:

JSON
{
  "accession": "0001437749-26-023109",
  "filed_date": "2026-07-09",
  "ticker": "AAPL",
  "company": "Apple Inc.",
  "insider_name": "COOK TIMOTHY D",
  "insider_role": "Director, Chief Executive Officer",
  "txn_date": "2026-07-08",
  "txn_code": "P",
  "shares": 25000,
  "price": 185.50,
  "value_usd": 4637500.00,
  "shares_after": 3250000
}

txn_code is "P" for an open-market purchase or "S" for an open-market sale — the API deliberately excludes grants, option exercises, and tax-withholding transactions, so every row you receive is a genuine open-market trade.

Core Endpoints Reference

EndpointMethodPurpose
/healthGETService status and data freshness check.
/trades/latestGETStream the most recent Form 4 filings hitting the wire.
/trades/{ticker}GETQuery complete chronological insider history for a specific equity.
/signals/cluster-buysGETFilter for high-density, multi-insider buying activity inside a rolling window, ranked by a proprietary conviction score.
/signals/c-suite-convictionGETIsolate open-market buying executed exclusively by C-suite executives (CEO, CFO, COO).
/stats/buy-sell-ratioGETAggregate buy vs. sell dollar totals per ticker over a rolling window.

Rate Limits & Errors

Endpoints are rate-limited per your plan tier. When a limit is breached, the gateway drops the request before it reaches the backend.

  • Free — $0/mo, 100 requests per month.
  • Pro — $29/mo, 5,000 requests per month.
  • Ultra — $59/mo, 30,000 requests per month.

Error Codes

  • 401 Unauthorized — missing or invalid RapidAPI key (enforced at the gateway, before reaching the backend).
  • 403 Forbidden — request did not carry a valid proxy signature (only occurs on direct, non-RapidAPI-routed calls, which are blocked by design).
  • 404 Not Found — no Form 4 filings exist in the database for the ticker specified.
  • 429 Too Many Requests — monthly plan quota exceeded.