secform4.com APIsecform4.com ↗
Access SEC Form 4 insider buys/sells, 13D/13G filings, institutional holders, and hedge fund portfolios via the secform4.com API. 11 endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/04fa8df4-9725-4e74-8dda-be7bb87bdce1/get_insider_buys' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns a list of recent insider purchase transactions. Data is delayed by 6 months for public users.
No input parameters required.
{
"type": "object",
"fields": {
"items": "array of insider buy transaction objects with transaction_date, reported_datetime, company, symbol, insider_relationship, shares_traded, average_price, total_amount, shares_owned, filing, and associated URLs"
},
"sample": {
"data": {
"items": [
{
"filing": "View",
"symbol": "QNBC",
"company": "QNB CORP.",
"filing_url": "https://www.secform4.com/filings/750558/0001814053-25-000003.htm",
"company_url": "https://www.secform4.com/insider-trading/750558.htm",
"shares_owned": "261,384 (Direct)",
"total_amount": "$32,025",
"average_price": "$35",
"shares_traded": "915",
"transaction_date": "2025-11-13 Purchase",
"reported_datetime": "2025-11-17 3:06 pm",
"insider_relationship": "Bimes Randy S. Director"
}
]
},
"status": "success"
}
}About the secform4.com API
The secform4.com API exposes 11 endpoints covering SEC Form 4 insider transactions, Schedule 13D/13G filings, and institutional portfolio data. You can pull recent insider buys and sales, filter to significant purchases, retrieve buy/sell ratio time series going back to 2003, and query full transaction histories by SEC CIK number using get_company_insider_trading. All data maps directly to public SEC filing records.
Insider Transaction Endpoints
Three endpoints cover open-market insider activity: get_insider_buys and get_insider_sales return paginated lists of recent Form 4 transactions with fields including transaction_date, reported_datetime, company, symbol, insider_relationship, and share counts. get_significant_insider_buys narrows those results to larger-dollar purchases only. Note that data from get_insider_buys is delayed by six months for public-plan users. A fourth endpoint, get_stock_options, covers option-related transactions — exercises, awards, grants, conversions, and tax withholding events — and adds an exercisable_expiration field.
Aggregate and Historical Data
get_insider_buy_sell_ratios returns a daily time series of aggregate insider buy and sell counts plus dollar volumes, with coverage starting in 2003. The response also includes parallel arrays for the S&P 500, Dow Jones, and NASDAQ under marketIndex, keyed by marketIndexName, enabling direct overlay of insider sentiment against broad market movement. get_company_insider_trading accepts a cik parameter (e.g. 320193 for Apple) and returns the complete filing history for that issuer.
Institutional Holdings and Hedge Fund Portfolios
get_institution_holders takes a company cik (plus optional name, symbol, and shares_outstanding) and returns per-quarter holder counts via holderCntList, net money flow via moneyflow, and a tableData array with per-institution fields: newShares, value, portWeight, sharesChanged, and moneyFlow. get_hedge_fund_portfolio flips the perspective — given an institution's cik (e.g. 1067983 for Berkshire Hathaway), it returns that fund's holdings table, quarterly valueHistory, and an sp500 comparison array. An optional quarter parameter (e.g. 2025Q4) retrieves historical snapshots.
Schedule 13D and 13G Filings
get_13d_filings and get_13g_filings return recent large-ownership disclosures. Each object includes reported_datetime, transaction_date, type, company_symbol, filed_by_symbol, and shares_owned_owned. 13D filings indicate activist or controlling positions above 5%; 13G filings indicate passive positions above 5%. The search endpoint accepts a ticker, CIK, or company name and returns matching insider transaction records across the database.
- Alert on significant insider purchases using get_significant_insider_buys when dollar value crosses a threshold
- Chart aggregate insider sentiment vs. S&P 500 performance using buy/sell ratio and marketIndex arrays from get_insider_buy_sell_ratios
- Track all insider transactions for a specific company over time using get_company_insider_trading with its SEC CIK
- Monitor 13D activist filings to detect new positions above 5% ownership using get_13d_filings
- Build a quarterly institutional holder trend dashboard using holderCntList and moneyflow from get_institution_holders
- Reconstruct a hedge fund's portfolio changes quarter-over-quarter using get_hedge_fund_portfolio with the quarter parameter
- Search insider activity by ticker symbol to pull relevant transaction records into a stock research workflow
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does secform4.com have an official developer API?+
What does get_insider_buy_sell_ratios actually return, and how far back does the data go?+
buySells object containing parallel date, buy count, sell count, buy dollar volume, and sell dollar volume arrays, with daily data points going back to 2003. A separate marketIndex object contains per-quarter index values for the S&P 500, Dow Jones, and NASDAQ, identified by the marketIndexName array.Is insider transaction data current, or is there a delay?+
get_insider_buys endpoint explicitly notes a six-month delay for public-plan users. Other transaction endpoints do not document a delay in their descriptions, but SEC Form 4 filings themselves must be filed within two business days of the transaction, so underlying data freshness is bounded by that reporting window.Can I filter insider transactions by insider relationship type or dollar threshold?+
get_insider_buys, get_insider_sales, and get_stock_options return unfiltered recent lists. get_significant_insider_buys is the only pre-filtered variant, applying a dollar-size filter server-side. You can fork this API on Parse and revise it to add query parameters for relationship type, date range, or custom dollar thresholds.