NSIDERALERTNSIDERALERT
Developer Tools

NsiderAPI

Access real-time insider trading data, historical transactions, and sentiment scores programmatically. Build your own tools and integrations.

Request Access

Everything You Need to Build

Real-time data, powerful filtering, and AI-powered sentiment analysis

Real-Time Data

Access insider trades as soon as they're filed with the SEC. No delays, no caching.

GET /api/v1/trades/recent?hours=24
Returns all trades from the last 24 hours

Powerful Filtering

Filter by ticker, company, insider, trade type, value range, and date. Combine multiple filters for precise queries.

GET /api/v1/trades?ticker=AAPL&min_value=1000000
Returns AAPL trades over $1M

AI Sentiment Analysis

Get AI-powered sentiment scores based on insider trading activity. Know if insiders are bullish or bearish.

GET /api/v1/stocks/AAPL/sentiment
Returns sentiment analysis for AAPL

API Endpoints

Complete reference for all available endpoints

GET/api/v1/trades

Get insider trades with filtering and pagination

GET /api/v1/trades?ticker=AAPL&limit=50

Parameters

tickerstring• Filter by stock ticker
companystring• Filter by company name
insiderstring• Filter by insider name
trade_typestring• Filter by trade type
min_valuenumber• Minimum trade value
max_valuenumber• Maximum trade value
start_datestring• Start date (YYYY-MM-DD)
end_datestring• End date (YYYY-MM-DD)
limitnumber• Number of results (1-1000)
offsetnumber• Number of results to skip
GET/api/v1/trades/search

Search trades by company, insider, or ticker

GET /api/v1/trades/search?q=Apple&limit=50

Parameters

qstring• Search query (required)
limitnumber• Number of results (1-1000)
GET/api/v1/trades/recent

Get trades from the last N hours

GET /api/v1/trades/recent?hours=24

Parameters

hoursnumber• Number of hours to look back (1-168)
GET/api/v1/trades/significant

Get significant trades above a minimum value

GET /api/v1/trades/significant?min_value=1000000&limit=50

Parameters

min_valuenumber• Minimum trade value (default: 1000000)
limitnumber• Number of results (1-1000)
GET/api/v1/stocks/{ticker}/quote

Get real-time stock quote data

GET /api/v1/stocks/AAPL/quote

Parameters

tickerstring• Stock ticker symbol (path parameter)
GET/api/v1/stocks/{ticker}/sentiment

Get AI-powered sentiment analysis based on insider activity

GET /api/v1/stocks/AAPL/sentiment

Parameters

tickerstring• Stock ticker symbol (path parameter)
force_recalculateboolean• Force recalculation of sentiment
GET/api/v1/filings

Get SEC filings with filtering and pagination

GET /api/v1/filings?form_type=10-K&limit=50

Parameters

form_typestring• Filter by form type (10-K, 10-Q)
tickerstring• Filter by stock ticker
companystring• Filter by company name
limitnumber• Number of results (1-500)
offsetnumber• Number of results to skip
GET/api/v1/filings/{accession_number}

Get a specific filing by accession number

GET /api/v1/filings/0000320193-24-000001

Parameters

accession_numberstring• SEC filing accession number (path parameter)

Getting Started

Learn how to authenticate and make your first API request

Authentication

All API requests require authentication using an API key. Include your API key in the request headers using one of the following methods:

Option 1: X-API-Key Header

X-API-Key: your_api_key_here

Option 2: Authorization Bearer

Authorization: Bearer your_api_key_here

Base URL

All API requests should be made to:

https://api.nsideralert.com/api/v1

Example Requests

cURL

curl -X GET "https://api.nsideralert.com/api/v1/trades?ticker=AAPL&limit=10" \
  -H "X-API-Key: your_api_key_here"

Python

import requests

headers = {
    "X-API-Key": "your_api_key_here"
}

response = requests.get(
    "https://api.nsideralert.com/api/v1/trades",
    headers=headers,
    params={"ticker": "AAPL", "limit": 10}
)

data = response.json()

JavaScript (Fetch)

const response = await fetch(
  "https://api.nsideralert.com/api/v1/trades?ticker=AAPL&limit=10",
  {
    headers: {
      "X-API-Key": "your_api_key_here"
    }
  }
);

const data = await response.json();

Response Format

All responses are returned in JSON format. Successful requests return a 200 status code with the requested data. Errors return appropriate HTTP status codes with error details.

{
  "trades": [
    {
      "id": 12345,
      "ticker": "AAPL",
      "company": "Apple Inc.",
      "insider": "Tim Cook",
      "trade_type": "P - Purchase",
      "price": "150.25",
      "quantity": 10000,
      "value": "1502500.00",
      "trade_date": "2024-01-15"
    }
  ],
  "count": 1,
  "limit": 10,
  "offset": 0
}

Request API Access

Loading...