GET /v1/insiders - SEC API for AI

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/insiders?ticker=AAPL&forms=4&limit=10"

{
  "object": "list",
  "data": [{
    "object": "insider_trade",
    "ownerName": "Example reporting owner",
    "ownerTitle": "Chief Executive Officer",
    "form": "4",
    "filingDate": "2026-07-01",
    "transactionDate": "2026-06-30",
    "transactionCode": "P",
    "transactionDirection": "acquired",
    "transactionShares": 1000,
    "transactionPrice": 25.5,
    "transactionValue": 25500,
    "accessionNumber": "0000000000-00-000000",
    "provenance": { "source": "sec", "filingUrl": "https://www.sec.gov/Archives/..." }
  }],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Return recent normalized insider trading records derived from Forms 3, 4, and 5 with date filters and cursor pagination

Audience: application and coding agent.

Agent mode

Pass ?view=agent to receive the compact agent shape: trade essentials (ticker, form, dates, code, direction, security title, shares, price, value, accession) + lifted filingUrl. Ownership flags (isDirector, isOfficer, sharesOwnedPrior/Following) and metadata envelopes are dropped. Typical reduction: ~55%. See api conventions → response formats for the full ?view= contract.

Canonical metadata

requestId
traceparent
provenance
freshness
materialization

Example request

curl -X GET -H "x-api-key: $SECAPI_API_KEY" -H "secapi-version: 2026-03-19" "https://api.secapi.ai/v1/insiders?ticker=AAPL&forms=4&limit=10"

Example response

{
  "object": "list",
  "data": [{
    "object": "insider_trade",
    "ownerName": "Example reporting owner",
    "ownerTitle": "Chief Executive Officer",
    "form": "4",
    "filingDate": "2026-07-01",
    "transactionDate": "2026-06-30",
    "transactionCode": "P",
    "transactionDirection": "acquired",
    "transactionShares": 1000,
    "transactionPrice": 25.5,
    "transactionValue": 25500,
    "accessionNumber": "0000000000-00-000000",
    "provenance": { "source": "sec", "filingUrl": "https://www.sec.gov/Archives/..." }
  }],
  "hasMore": false,
  "nextCursor": null,
  "requestId": "req_2ZK8Q1W9F4M6P7R3"
}

Give this prompt to your agent

Failure posture

treat non-2xx responses as contract-aware failures, not free-form errors
preserve requestId and traceparent in logs and downstream reports
if provenance or freshness metadata is present, return it unchanged so trust is not lost in the handoff

Insiders Intelligence

​Agent mode

​Canonical metadata

​Example request

​Example response

​Give this prompt to your agent

​Failure posture

Agent mode

Canonical metadata

Example request

Example response

Give this prompt to your agent

Failure posture