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:
X-RapidAPI-Key: YOUR_API_KEY_HERE X-RapidAPI-Host: nexusform4-sec-insider-trading-c-suite-signals.p.rapidapi.com
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.
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)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:
{
"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
| Endpoint | Method | Purpose |
|---|---|---|
| /health | GET | Service status and data freshness check. |
| /trades/latest | GET | Stream the most recent Form 4 filings hitting the wire. |
| /trades/{ticker} | GET | Query complete chronological insider history for a specific equity. |
| /signals/cluster-buys | GET | Filter for high-density, multi-insider buying activity inside a rolling window, ranked by a proprietary conviction score. |
| /signals/c-suite-conviction | GET | Isolate open-market buying executed exclusively by C-suite executives (CEO, CFO, COO). |
| /stats/buy-sell-ratio | GET | Aggregate 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.