API Documentation

Integrate InsiderWatch signals into your trading algorithms, dashboards, or applications.

Authentication

All API requests require an API key sent in the X-API-Key header. Generate a key in Settings.

curl -H "X-API-Key: iw_live_your_key_here" \
  https://insider-api.wizybit.com/v1/scores/AAPL

API keys require Trader tier or above.

Rate Limits

Rate limits apply per API key per day. Web dashboard usage does not count toward API limits.

Plan	Daily Requests	Batch Size
Free	No API access	—
Trader ($29/mo)	100 requests/day	10 tickers
Pro ($79/mo)	1,000 requests/day	50 tickers
Enterprise ($299/mo)	10,000 requests/day	200 tickers

Every response includes X-RateLimit-Remaining header showing your remaining quota.

Endpoints

GET/v1/scores/All tiers

Daily summary of bullish and bearish insider signals.

Show example

Request:

curl -H "X-API-Key: iw_live_xxx" \
  https://insider-api.wizybit.com/v1/scores/

Response:

{
  "date": "2026-04-15",
  "total_monitored": 499,
  "total_with_signals": 86,
  "bullish": [
    {"ticker": "RL", "score": 100.0, "signal_summary": "cluster_buy", "filing_count": 9}
  ],
  "bearish": [
    {"ticker": "PGR", "score": -100.0, "signal_summary": "net_sell", "filing_count": 20}
  ]
}

GET/v1/scores/{ticker}All tiers

Score and signal for a single ticker.

Show example

Request:

curl -H "X-API-Key: iw_live_xxx" \
  https://insider-api.wizybit.com/v1/scores/AAPL

Response:

{
  "ticker": "AAPL",
  "score": 45.0,
  "signal_summary": "net_buy",
  "filing_count": 3,
  "last_transaction": "2026-04-12",
  "news_sentiment": 1
}

POST/v1/scores/batchTrader+

Batch lookup for multiple tickers in a single request.

Show example

Request:

curl -X POST -H "X-API-Key: iw_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"tickers": ["AAPL", "MSFT", "NVDA"]}' \
  https://insider-api.wizybit.com/v1/scores/batch

Response:

[
  {"ticker": "AAPL", "score": 45.0, "signal_summary": "net_buy", "filing_count": 3},
  {"ticker": "MSFT", "score": -20.0, "signal_summary": "net_sell", "filing_count": 2}
]

GET/v1/filings/{ticker}Trader+

Insider filing history with AI reasoning for a ticker.

Show example

Request:

curl -H "X-API-Key: iw_live_xxx" \
  "https://insider-api.wizybit.com/v1/filings/AAPL?days=30"

Response:

{
  "ticker": "AAPL",
  "days": 30,
  "count": 3,
  "filings": [
    {
      "id": 42,
      "filing_date": "2026-04-12",
      "insider_name": "Tim Cook",
      "insider_role": "ceo",
      "transaction_type": "buy",
      "shares": 50000,
      "price": 195.50,
      "total_value": 9775000,
      "ai_reasoning": "CEO purchase at market price suggests confidence in upcoming earnings.",
      "ai_confidence": 0.92
    }
  ]
}

Python Example

import requests

API_KEY = "iw_live_your_key_here"
BASE = "https://insider-api.wizybit.com/v1"

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

# Get today's signals
signals = requests.get(f"{BASE}/scores/", headers=headers).json()

for s in signals["bullish"]:
    print(f'{s["ticker"]}: {s["score"]:+.0f} ({s["signal_summary"]})')

# Get filings for a ticker
filings = requests.get(f"{BASE}/filings/AAPL?days=30", headers=headers).json()

for f in filings["filings"]:
    print(f'{f["insider_name"]} {f["transaction_type"]} {f["shares"]} shares')
    if f["ai_reasoning"]:
        print(f'  AI: {f["ai_reasoning"]}')

Error Codes

Code	Meaning
401	Missing or invalid API key
403	Feature not available on your plan
404	Ticker not found or no data
429	Daily rate limit exceeded
500	Server error

Create Free Account