InsiderIQ Pro · REST API
REST endpoints returning conviction-scored SEC Form 4 signals, historical backtest results, and real-time webhook alerts. All responses are JSON.
GET /v1/signals/latest
Latest high-conviction insider purchases, scored against six backtested factors. Filter by min score, ticker, or date range.
GET /v1/signals/{id}/returns
30/60/90-day forward returns and alpha vs. SPY for any scored signal — the same data powering the subscriber dashboard.
POST your-endpoint
Register a URL and receive a signed JSON payload within seconds of a high-conviction Form 4 filing hitting EDGAR.
/v1/openapi.json
Machine-readable spec for every endpoint. Plug into Postman, Insomnia, or any OpenAPI-aware codegen tool.
Quick Start
Pass your ik_live_ bearer token, optionally filter by min_score, and get back conviction-scored signals with forward returns.
Sample Response
{
"signals": [
{
"ticker": "NVDA",
"conviction_score": 14,
"insider": "Jensen Huang",
"role": "CEO",
"transaction_value": 2450000,
"trans_date": "2024-11-12",
"returns": {
"r30": 0.142,
"r60": 0.198,
"r90": 0.261
}
}
]
}Every endpoint is described in a machine-readable spec. Import into Postman, generate a client with openapi-generator, or use the interactive reference — all included with Pro.
Every response is derived from SEC EDGAR Form 4 filings — the mandatory disclosure insiders file within two business days of an open-market purchase. Our scoring algorithm applies six factors (cluster buying, CEO/CFO role, purchase size relative to salary, recent IPO proximity, and more) to rank conviction level. The API returns the raw filing data plus the derived conviction score and historical 30/60/90-day return metrics.
New Form 4 filings are ingested from the EDGAR XBRL feed. Signals typically appear in the API and webhook deliveries within minutes of the filing becoming publicly available — usually the same day the insider reports the transaction.
All requests require a bearer token in the Authorization header. Keys use the ik_live_ prefix and are issued to InsiderIQ Pro subscribers. You can generate and rotate keys from your Settings page.
Pro subscribers get 60 requests per minute. Exceeded requests return HTTP 429 with a Retry-After header indicating how many seconds to wait before retrying.
Yes. The API is designed for integration into trading dashboards, research tools, and alerting pipelines. It includes a stable versioned base URL (/v1/), consistent JSON error envelopes, and webhook signatures for secure push delivery.
API access is included with InsiderIQ Pro. Generate your key from Settings and make your first request in under five minutes.