# Secform4 — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Track insider buying and selling activity, monitor institutional holdings, and analyze SEC filings to identify significant trades and market sentiment. Search company insider transactions, review 13D/13G filings, and access hedge fund portfolios to inform your investment decisions.

**Category:** Finance & Markets | **Website:** [secform4.com/](https://secform4.com/) | **Docs:** [parse.bot/marketplace/a56dfc20-a7a3-48db-9766-5437ed41cefb/secform4-com-api](https://parse.bot/marketplace/a56dfc20-a7a3-48db-9766-5437ed41cefb/secform4-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_13d_filings

Returns recent Schedule 13D filings showing significant ownership positions (>5%) in public companies. 13D filers are activist investors who intend to influence the company.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_13d_filings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_13g_filings

Returns recent Schedule 13G filings showing passive ownership positions (>5%) in public companies. 13G filers are passive investors who do not intend to influence the company.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_13g_filings \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_company_insider_trading

Returns the full insider trading history for a specific company identified by its SEC CIK number. Includes all buy, sell, and option transactions filed in Form 4s for the company.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cik` | string | Yes | SEC CIK number of the company (e.g. '320193' for Apple Inc, '789019' for Microsoft) |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_company_insider_trading \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cik":"<string>"}'
```

### get_hedge_fund_portfolio

Returns portfolio holdings for a specific institutional investor or hedge fund by CIK. Includes quarterly money flow, value history, S&P 500 comparison, summary info, and a detailed holdings table. The tableData holding field contains HTML with links to company pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cik` | string | Yes | SEC CIK number of the institution (e.g. '1067983' for Berkshire Hathaway) |
| `name` | string | No | Institution name for display context |
| `quarter` | string | No | Specific quarter to query in format YYYYQn (e.g. '2025Q4'). Omitting returns the latest available quarter. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_hedge_fund_portfolio \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cik":"<string>","name":"<string>","quarter":"<string>"}'
```

### get_insider_buy_sell_ratios

Returns aggregate insider buy/sell ratio data with daily data points going back to 2003. Includes buy count, sell count, buy dollar volume, sell dollar volume per day, plus market index comparison data for S&P 500, DOW, and NASDAQ.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_insider_buy_sell_ratios \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_insider_buys

Returns recent insider purchase transactions from SEC Form 4 filings. Data is delayed by 6 months for public users. Each transaction includes company info, insider relationship, share count, price, and filing link.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_insider_buys \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_insider_sales

Returns recent insider sale transactions from SEC Form 4 filings. Each transaction includes company info, insider relationship, share count, price, and filing link.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_insider_sales \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_institution_holders

Returns top institutional holders for a company by CIK, including quarterly holder counts, money flow data, and a detailed holder table with share counts and portfolio weights. The tableData holder field contains HTML with links to holder portfolio pages.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `cik` | string | Yes | SEC CIK number of the company (e.g. '320193' for Apple Inc) |
| `name` | string | No | Company name for display context |
| `shares_outstanding` | integer | No | Number of shares outstanding for ownership percentage calculation |
| `symbol` | string | No | Stock ticker symbol for display context |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_institution_holders \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"cik":"<string>","name":"<string>","shares_outstanding":"<integer>","symbol":"<string>"}'
```

### get_significant_insider_buys

Returns insider purchase transactions filtered to significant buys only (larger dollar amounts). Same fields as get_insider_buys but limited to higher-value transactions.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_significant_insider_buys \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_stock_options

Returns recent stock option transactions including exercises, awards, grants, conversions, and tax withholdings from SEC Form 4 filings.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/get_stock_options \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search

Searches for insider trading activity by company ticker symbol, CIK number, or company name. Returns all matching transaction records for the company including buys, sells, and option exercises.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Search query - company ticker symbol (e.g. 'AAPL'), CIK number (e.g. '320193'), or company name (e.g. 'Apple') |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-secform4-com-api-a56dfc20/search \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```