Insider Trading API
Overview
To use Insider Trading, you need an API key. You can get one by creating a free account and visiting your dashboard.
GET Endpoint
https://api.apiverve.com/v1/insidertradingExample
How to call the Insider Trading API in different programming languages.
curl -X GET \
"https://api.apiverve.com/v1/insidertrading?ticker=AAPL&type=buy&limit=10" \
-H "X-API-Key: your_api_key_here"const response = await fetch('https://api.apiverve.com/v1/insidertrading?ticker=AAPL&type=buy&limit=10', {
method: 'GET',
headers: {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
});
const data = await response.json();
console.log(data);import requests
headers = {
'X-API-Key': 'your_api_key_here',
'Content-Type': 'application/json'
}
response = requests.get('https://api.apiverve.com/v1/insidertrading?ticker=AAPL&type=buy&limit=10', headers=headers)
data = response.json()
print(data)package main
import (
"fmt"
"io"
"net/http"
)
func main() {
req, _ := http.NewRequest("GET", "https://api.apiverve.com/v1/insidertrading?ticker=AAPL&type=buy&limit=10", nil)
req.Header.Set("X-API-Key", "your_api_key_here")
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
panic(err)
}
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)
fmt.Println(string(body))
}{
"status": "ok",
"error": null,
"data": {
"ticker": "AAPL",
"cik": "0000320193",
"company": "Apple Inc.",
"totalRecentForm4": 512,
"count": 5,
"lastTransactionDate": "2025-10-14",
"daysSinceLastTransaction": 64,
"transactions": [
{
"filingDate": "2025-10-16",
"transactionDate": "2025-10-14",
"insiderName": "COOK TIMOTHY D",
"insiderTitle": "Chief Executive Officer",
"relationship": {
"director": true,
"officer": true,
"tenPercentOwner": false
},
"security": "Common Stock",
"transactionCode": "S",
"transactionType": "Sale",
"direction": "sell",
"acquiredDisposed": "D",
"shares": 511000,
"pricePerShare": 245.5,
"value": 125450500,
"sharesOwnedAfter": 3280000,
"accessionNumber": "0000320193-25-000118",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml"
},
{
"filingDate": "2025-10-02",
"transactionDate": "2025-10-01",
"insiderName": "MAESTRI LUCA",
"insiderTitle": "Senior Vice President, CFO",
"relationship": {
"director": false,
"officer": true,
"tenPercentOwner": false
},
"security": "Common Stock",
"transactionCode": "S",
"transactionType": "Sale",
"direction": "sell",
"acquiredDisposed": "D",
"shares": 74213,
"pricePerShare": 241.18,
"value": 17899091,
"sharesOwnedAfter": 112884,
"accessionNumber": "0000320193-25-000112",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000112/xslF345X05/wf-form4.xml"
},
{
"filingDate": "2025-08-20",
"transactionDate": "2025-08-18",
"insiderName": "WILLIAMS JEFFREY E",
"insiderTitle": "Chief Operating Officer",
"relationship": {
"director": false,
"officer": true,
"tenPercentOwner": false
},
"security": "Common Stock",
"transactionCode": "P",
"transactionType": "Purchase",
"direction": "buy",
"acquiredDisposed": "A",
"shares": 5000,
"pricePerShare": 226.4,
"value": 1132000,
"sharesOwnedAfter": 489210,
"accessionNumber": "0000320193-25-000101",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000101/xslF345X05/wf-form4.xml"
},
{
"filingDate": "2025-08-04",
"transactionDate": "2025-08-01",
"insiderName": "ADAMS KATHERINE L",
"insiderTitle": "Senior Vice President, General Counsel",
"relationship": {
"director": false,
"officer": true,
"tenPercentOwner": false
},
"security": "Common Stock",
"transactionCode": "A",
"transactionType": "Grant/Award",
"direction": null,
"acquiredDisposed": "A",
"shares": 25000,
"pricePerShare": 0,
"value": 0,
"sharesOwnedAfter": 312450,
"accessionNumber": "0000320193-25-000098",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000098/xslF345X05/wf-form4.xml"
},
{
"filingDate": "2025-08-04",
"transactionDate": "2025-08-01",
"insiderName": "O'BRIEN DEIRDRE",
"insiderTitle": "Senior Vice President",
"relationship": {
"director": false,
"officer": true,
"tenPercentOwner": false
},
"security": "Common Stock",
"transactionCode": "F",
"transactionType": "Tax Withholding",
"direction": null,
"acquiredDisposed": "D",
"shares": 8123,
"pricePerShare": 232.1,
"value": 1885348,
"sharesOwnedAfter": 145200,
"accessionNumber": "0000320193-25-000097",
"url": "https://www.sec.gov/Archives/edgar/data/320193/000032019325000097/xslF345X05/wf-form4.xml"
}
],
"summary": {
"totalTransactions": 5,
"distinctInsiders": 5,
"buys": {
"count": 1,
"shares": 5000,
"value": 1132000
},
"sells": {
"count": 2,
"shares": 585213,
"value": 143349591
},
"netShares": -580213,
"netValue": -142217591,
"buySellRatio": 0.01,
"sentiment": "Bearish",
"clusterBuy": false
}
}
}Authentication
The Insider Trading API requires authentication via API key. Include your API key in the request header:
X-API-Key: your_api_key_hereInteractive API Playground
Test the Insider Trading API directly in your browser with live requests and responses.
Parameters
The following parameters are available for the Insider Trading API:
Get Insider Trading by Ticker
| Parameter | Type | Required | Description | Default | Example |
|---|---|---|---|---|---|
ticker | string | required | Stock ticker symbol (e.g. AAPL, MSFT, ADBE) Length: 1 - 6 chars | - | |
typePremium | string | optional | Filter to open-market buys or sells (buy or sell). | - | |
limitPremium | integer | optional | Number of transactions to return (1-25). Defaults to 5. Range: 1 - 25 | - |
Response
The Insider Trading API returns responses in JSON, XML, YAML, and CSV formats. The JSON response is shown in the Example section above; alternative formats below.
Other Response Formats
<?xml version="1.0" encoding="UTF-8"?>
<response>
<status>ok</status>
<error xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<data>
<ticker>AAPL</ticker>
<cik>0000320193</cik>
<company>Apple Inc.</company>
<totalRecentForm4>512</totalRecentForm4>
<count>5</count>
<lastTransactionDate>2025-10-14</lastTransactionDate>
<daysSinceLastTransaction>64</daysSinceLastTransaction>
<transactions>
<transaction>
<filingDate>2025-10-16</filingDate>
<transactionDate>2025-10-14</transactionDate>
<insiderName>COOK TIMOTHY D</insiderName>
<insiderTitle>Chief Executive Officer</insiderTitle>
<relationship>
<director>true</director>
<officer>true</officer>
<tenPercentOwner>false</tenPercentOwner>
</relationship>
<security>Common Stock</security>
<transactionCode>S</transactionCode>
<transactionType>Sale</transactionType>
<direction>sell</direction>
<acquiredDisposed>D</acquiredDisposed>
<shares>511000</shares>
<pricePerShare>245.5</pricePerShare>
<value>125450500</value>
<sharesOwnedAfter>3280000</sharesOwnedAfter>
<accessionNumber>0000320193-25-000118</accessionNumber>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml</url>
</transaction>
<transaction>
<filingDate>2025-10-02</filingDate>
<transactionDate>2025-10-01</transactionDate>
<insiderName>MAESTRI LUCA</insiderName>
<insiderTitle>Senior Vice President, CFO</insiderTitle>
<relationship>
<director>false</director>
<officer>true</officer>
<tenPercentOwner>false</tenPercentOwner>
</relationship>
<security>Common Stock</security>
<transactionCode>S</transactionCode>
<transactionType>Sale</transactionType>
<direction>sell</direction>
<acquiredDisposed>D</acquiredDisposed>
<shares>74213</shares>
<pricePerShare>241.18</pricePerShare>
<value>17899091</value>
<sharesOwnedAfter>112884</sharesOwnedAfter>
<accessionNumber>0000320193-25-000112</accessionNumber>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000112/xslF345X05/wf-form4.xml</url>
</transaction>
<transaction>
<filingDate>2025-08-20</filingDate>
<transactionDate>2025-08-18</transactionDate>
<insiderName>WILLIAMS JEFFREY E</insiderName>
<insiderTitle>Chief Operating Officer</insiderTitle>
<relationship>
<director>false</director>
<officer>true</officer>
<tenPercentOwner>false</tenPercentOwner>
</relationship>
<security>Common Stock</security>
<transactionCode>P</transactionCode>
<transactionType>Purchase</transactionType>
<direction>buy</direction>
<acquiredDisposed>A</acquiredDisposed>
<shares>5000</shares>
<pricePerShare>226.4</pricePerShare>
<value>1132000</value>
<sharesOwnedAfter>489210</sharesOwnedAfter>
<accessionNumber>0000320193-25-000101</accessionNumber>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000101/xslF345X05/wf-form4.xml</url>
</transaction>
<transaction>
<filingDate>2025-08-04</filingDate>
<transactionDate>2025-08-01</transactionDate>
<insiderName>ADAMS KATHERINE L</insiderName>
<insiderTitle>Senior Vice President, General Counsel</insiderTitle>
<relationship>
<director>false</director>
<officer>true</officer>
<tenPercentOwner>false</tenPercentOwner>
</relationship>
<security>Common Stock</security>
<transactionCode>A</transactionCode>
<transactionType>Grant/Award</transactionType>
<direction xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<acquiredDisposed>A</acquiredDisposed>
<shares>25000</shares>
<pricePerShare>0</pricePerShare>
<value>0</value>
<sharesOwnedAfter>312450</sharesOwnedAfter>
<accessionNumber>0000320193-25-000098</accessionNumber>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000098/xslF345X05/wf-form4.xml</url>
</transaction>
<transaction>
<filingDate>2025-08-04</filingDate>
<transactionDate>2025-08-01</transactionDate>
<insiderName>O'BRIEN DEIRDRE</insiderName>
<insiderTitle>Senior Vice President</insiderTitle>
<relationship>
<director>false</director>
<officer>true</officer>
<tenPercentOwner>false</tenPercentOwner>
</relationship>
<security>Common Stock</security>
<transactionCode>F</transactionCode>
<transactionType>Tax Withholding</transactionType>
<direction xsi:nil="true" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
<acquiredDisposed>D</acquiredDisposed>
<shares>8123</shares>
<pricePerShare>232.1</pricePerShare>
<value>1885348</value>
<sharesOwnedAfter>145200</sharesOwnedAfter>
<accessionNumber>0000320193-25-000097</accessionNumber>
<url>https://www.sec.gov/Archives/edgar/data/320193/000032019325000097/xslF345X05/wf-form4.xml</url>
</transaction>
</transactions>
<summary>
<totalTransactions>5</totalTransactions>
<distinctInsiders>5</distinctInsiders>
<buys>
<count>1</count>
<shares>5000</shares>
<value>1132000</value>
</buys>
<sells>
<count>2</count>
<shares>585213</shares>
<value>143349591</value>
</sells>
<netShares>-580213</netShares>
<netValue>-142217591</netValue>
<buySellRatio>0.01</buySellRatio>
<sentiment>Bearish</sentiment>
<clusterBuy>false</clusterBuy>
</summary>
</data>
</response>
status: ok
error: null
data:
ticker: AAPL
cik: '0000320193'
company: Apple Inc.
totalRecentForm4: 512
count: 5
lastTransactionDate: '2025-10-14'
daysSinceLastTransaction: 64
transactions:
- filingDate: '2025-10-16'
transactionDate: '2025-10-14'
insiderName: COOK TIMOTHY D
insiderTitle: Chief Executive Officer
relationship:
director: true
officer: true
tenPercentOwner: false
security: Common Stock
transactionCode: S
transactionType: Sale
direction: sell
acquiredDisposed: D
shares: 511000
pricePerShare: 245.5
value: 125450500
sharesOwnedAfter: 3280000
accessionNumber: 0000320193-25-000118
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml
- filingDate: '2025-10-02'
transactionDate: '2025-10-01'
insiderName: MAESTRI LUCA
insiderTitle: Senior Vice President, CFO
relationship:
director: false
officer: true
tenPercentOwner: false
security: Common Stock
transactionCode: S
transactionType: Sale
direction: sell
acquiredDisposed: D
shares: 74213
pricePerShare: 241.18
value: 17899091
sharesOwnedAfter: 112884
accessionNumber: 0000320193-25-000112
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000112/xslF345X05/wf-form4.xml
- filingDate: '2025-08-20'
transactionDate: '2025-08-18'
insiderName: WILLIAMS JEFFREY E
insiderTitle: Chief Operating Officer
relationship:
director: false
officer: true
tenPercentOwner: false
security: Common Stock
transactionCode: P
transactionType: Purchase
direction: buy
acquiredDisposed: A
shares: 5000
pricePerShare: 226.4
value: 1132000
sharesOwnedAfter: 489210
accessionNumber: 0000320193-25-000101
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000101/xslF345X05/wf-form4.xml
- filingDate: '2025-08-04'
transactionDate: '2025-08-01'
insiderName: ADAMS KATHERINE L
insiderTitle: Senior Vice President, General Counsel
relationship:
director: false
officer: true
tenPercentOwner: false
security: Common Stock
transactionCode: A
transactionType: Grant/Award
direction: null
acquiredDisposed: A
shares: 25000
pricePerShare: 0
value: 0
sharesOwnedAfter: 312450
accessionNumber: 0000320193-25-000098
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000098/xslF345X05/wf-form4.xml
- filingDate: '2025-08-04'
transactionDate: '2025-08-01'
insiderName: O'BRIEN DEIRDRE
insiderTitle: Senior Vice President
relationship:
director: false
officer: true
tenPercentOwner: false
security: Common Stock
transactionCode: F
transactionType: Tax Withholding
direction: null
acquiredDisposed: D
shares: 8123
pricePerShare: 232.1
value: 1885348
sharesOwnedAfter: 145200
accessionNumber: 0000320193-25-000097
url: >-
https://www.sec.gov/Archives/edgar/data/320193/000032019325000097/xslF345X05/wf-form4.xml
summary:
totalTransactions: 5
distinctInsiders: 5
buys:
count: 1
shares: 5000
value: 1132000
sells:
count: 2
shares: 585213
value: 143349591
netShares: -580213
netValue: -142217591
buySellRatio: 0.01
sentiment: Bearish
clusterBuy: false
| key | value |
|---|---|
| ticker | AAPL |
| cik | 0000320193 |
| company | Apple Inc. |
| totalRecentForm4 | 512 |
| count | 5 |
| lastTransactionDate | 2025-10-14 |
| daysSinceLastTransaction | 64 |
| transactions | [{filingDate:2025-10-16,transactionDate:2025-10-14,insiderName:COOK TIMOTHY D,insiderTitle:Chief Executive Officer,relationship:{director:true,officer:true,tenPercentOwner:false},security:Common Stock,transactionCode:S,transactionType:Sale,direction:sell,acquiredDisposed:D,shares:511000,pricePerShare:245.5,value:125450500,sharesOwnedAfter:3280000,accessionNumber:0000320193-25-000118,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000118/xslF345X05/wf-form4.xml},{filingDate:2025-10-02,transactionDate:2025-10-01,insiderName:MAESTRI LUCA,insiderTitle:Senior Vice President, CFO,relationship:{director:false,officer:true,tenPercentOwner:false},security:Common Stock,transactionCode:S,transactionType:Sale,direction:sell,acquiredDisposed:D,shares:74213,pricePerShare:241.18,value:17899091,sharesOwnedAfter:112884,accessionNumber:0000320193-25-000112,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000112/xslF345X05/wf-form4.xml},{filingDate:2025-08-20,transactionDate:2025-08-18,insiderName:WILLIAMS JEFFREY E,insiderTitle:Chief Operating Officer,relationship:{director:false,officer:true,tenPercentOwner:false},security:Common Stock,transactionCode:P,transactionType:Purchase,direction:buy,acquiredDisposed:A,shares:5000,pricePerShare:226.4,value:1132000,sharesOwnedAfter:489210,accessionNumber:0000320193-25-000101,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000101/xslF345X05/wf-form4.xml},{filingDate:2025-08-04,transactionDate:2025-08-01,insiderName:ADAMS KATHERINE L,insiderTitle:Senior Vice President, General Counsel,relationship:{director:false,officer:true,tenPercentOwner:false},security:Common Stock,transactionCode:A,transactionType:Grant/Award,direction:null,acquiredDisposed:A,shares:25000,pricePerShare:0,value:0,sharesOwnedAfter:312450,accessionNumber:0000320193-25-000098,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000098/xslF345X05/wf-form4.xml},{filingDate:2025-08-04,transactionDate:2025-08-01,insiderName:O'BRIEN DEIRDRE,insiderTitle:Senior Vice President,relationship:{director:false,officer:true,tenPercentOwner:false},security:Common Stock,transactionCode:F,transactionType:Tax Withholding,direction:null,acquiredDisposed:D,shares:8123,pricePerShare:232.1,value:1885348,sharesOwnedAfter:145200,accessionNumber:0000320193-25-000097,url:https://www.sec.gov/Archives/edgar/data/320193/000032019325000097/xslF345X05/wf-form4.xml}] |
| summary | {totalTransactions:5,distinctInsiders:5,buys:{count:1,shares:5000,value:1132000},sells:{count:2,shares:585213,value:143349591},netShares:-580213,netValue:-142217591,buySellRatio:0.01,sentiment:Bearish,clusterBuy:false} |
Response Structure
All API responses follow a consistent structure with the following fields:
| Field | Type | Description | Example |
|---|---|---|---|
status | string | Indicates whether the request was successful ("ok") or failed ("error") | ok |
error | string | null | Contains error message if status is "error", otherwise null | null |
data | object | null | Contains the API response data if successful, otherwise null | {...} |
Learn more about response formats →
Response Data Fields
When the request is successful, the data object contains the following fields:
| Field | Type | Sample Value | Description |
|---|---|---|---|
ticker | string | Stock ticker symbol for the company | |
cik | string | SEC Central Index Key unique identifier | |
company | string | Official registered name of the company | |
totalRecentForm4 | number | Total Form 4 filings in the company's recent feed | |
count | number | Number of transactions returned in this response | |
lastTransactionDate | string | Date of the most recent insider transaction | |
daysSinceLastTransactionPremium | number | Days since the most recent insider transaction | |
| [ ] Array items: | array[5] | Recent insider transactions, most recent first | |
└ filingDate | string | Date the Form 4 was filed | |
└ transactionDate | string | Date the transaction occurred | |
└ insiderName | string | Name of the reporting insider | |
└ insiderTitle | string | Role or title of the insider | |
└ relationship | object | Insider relationship flags (director, officer, 10% owner) | |
└ director | boolean | - | |
└ officer | boolean | - | |
└ tenPercentOwner | boolean | - | |
└ security | string | Title of the security transacted | |
└ transactionCode | string | SEC transaction code (P, S, A, M, F, ...) | |
└ transactionType | string | Human-readable transaction type | |
└ direction | string | Open-market direction (buy or sell), when applicable |
Headers
Only X-API-Key is required. Optional headers include Accept for response format negotiation (JSON, XML, or YAML), User-Agent, and X-Request-ID for request tracing. See all request headers →
GraphQL AccessALPHA
Access Insider Trading through GraphQL to combine it with other API calls in a single request. Query only the insider trading data you need with precise field selection, and orchestrate complex data fetching workflows.
Credit Cost: Each API called in your GraphQL query consumes its standard credit cost.
POST https://api.apiverve.com/v1/graphqlquery {
insidertrading(
input: {
ticker: "AAPL"
type: "buy"
limit: 10
}
) {
ticker
cik
company
totalRecentForm4
count
lastTransactionDate
daysSinceLastTransaction
transactions
summary {
totalTransactions
distinctInsiders
buys {
count
shares
value
}
sells {
count
shares
value
}
netShares
netValue
buySellRatio
sentiment
clusterBuy
}
}
}Note: Authentication is handled via the x-api-key header in your GraphQL request, not as a query parameter.
CORS Support
The Insider Trading API accepts cross-origin requests from any origin, so it can be called directly from browser-based applications without a proxy. See CORS support →
Rate Limiting
Insider Trading requests are throttled per minute on the Free plan and unthrottled on paid plans. Exceeding the limit returns 429 Too Many Requests; rate-limit usage is reported in the X-RateLimit-Limit, X-RateLimit-Remaining, and X-RateLimit-Reset response headers. See per-plan limits and best practices →
Error Codes
The Insider Trading API uses standard HTTP status codes — 200 on success, 400 for invalid parameters, 401 for missing or invalid keys, 403 for insufficient credits, 429 for rate-limit exhaustion, and 500/503 for server-side issues. Each error response includes an X-Request-ID header you can quote when contacting support. See full error handling guide →
SDKs for Insider Trading
Official Insider Trading packages on npm, PyPI, NuGet, and JitPack — plus a Postman collection and an OpenAPI spec. See the SDK guide →
No-Code Integrations
Insider Trading works with Zapier, Make, Pipedream, n8n, and Power Automate using the same API key. See setup guides →
Frequently Asked Questions
How do I get an API key for Insider Trading?
How many credits does Insider Trading cost?
Each successful Insider Trading API call consumes credits based on plan tier. Check the pricing section above for the exact credit cost. Failed requests and errors don't consume credits, so you only pay for successful insider trading lookups.
Can I use Insider Trading in production?
The free plan is for testing and development only. For production use of Insider Trading, upgrade to a paid plan (Starter, Pro, or Mega) which includes commercial use rights, no attribution requirements, and guaranteed uptime SLAs. All paid plans are production-ready.
Can I use Insider Trading from a browser?
What happens if I exceed my Insider Trading credit limit?
When you reach your monthly credit limit, Insider Trading API requests will return an error until you upgrade your plan or wait for the next billing cycle. You'll receive notifications at 80% and 95% usage to give you time to upgrade if needed.








