# SEC Executive Liquidity Signals (`abundancewoman/sec-executive-liquidity-signals`) Actor

- **URL**: https://apify.com/abundancewoman/sec-executive-liquidity-signals.md
- **Developed by:** [Maria lanau prada](https://apify.com/abundancewoman) (community)
- **Categories:**
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

$0.19 / actor start

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## SEC Executive Liquidity Signals

Detect commercially relevant executive and insider liquidity events from official SEC Form 4 filings.

This Actor does not simply return raw SEC filings. It filters and scores insider stock-sale activity to surface potentially meaningful liquidity events for wealth management, private banking, financial advisory prospecting, market intelligence, and AI agents.

### What this Actor analyzes

The Actor evaluates recent SEC Form 4 filings and focuses on open-market sales reported with transaction code `S`.

It currently considers:

- Estimated transaction value
- Insider role
- Reported percentage of the position sold
- Shares remaining after the transaction
- Whether a 10b5-1 plan is referenced
- Recent Form 4 history for the same insider
- Whether the sale appears unusually large compared with recent activity
- Whether the event appears to be the first major sale detected in the previous 12 months

### Human executive filtering

The Actor attempts to remove reporting owners that appear to be companies, funds, holding companies, investment vehicles, or other entities.

The current version prioritizes individual insiders such as:

- CEO
- Founder
- CFO
- COO
- CTO
- President
- Chair
- Executive Vice President
- Senior Vice President
- Directors
- Other officers
- Individual 10% owners

### Signal strength

Each qualified result receives a liquidity score and signal strength.

Possible classifications include:

- MEDIUM
- HIGH
- CRITICAL

Weak signals below the internal qualification threshold are not returned.

### Historical signals

The Actor may classify an event as:

- FIRST\_MAJOR\_SALE\_12M
- UNUSUAL\_VS\_RECENT\_HISTORY
- RECURRING\_SELLER
- HISTORY\_UNAVAILABLE

Historical analysis is based on a limited review of recent SEC Form 4 filings for the same reporting owner.

### Example output

{
"signal\_type": "EXECUTIVE\_LIQUIDITY\_EVENT",
"signal\_strength": "HIGH",
"liquidity\_score": 82,
"base\_liquidity\_score": 70,
"history\_score\_bonus": 12,
"abnormal\_liquidity\_event": true,
"historical\_signal": "FIRST\_MAJOR\_SALE\_12M",
"first\_major\_sale\_12m": true,
"unusual\_vs\_recent\_history": true,
"prior\_form4\_filings\_12m": 3,
"prior\_sale\_events\_found": 0,
"prior\_major\_sales\_found": 0,
"largest\_prior\_sale\_usd": null,
"analysis\_status": "QUALIFIED\_SIGNAL\_V2",
"issuer": "Example Corporation",
"ticker": "EXM",
"issuer\_cik": "0000000000",
"insider\_name": "Example Executive",
"insider\_cik": "0000000000",
"insider\_role": "Chief Executive Officer",
"sec\_form": "4",
"filing\_date": "2026-09-01",
"transaction\_date": "2026-08-31",
"estimated\_value\_usd": 5400000,
"total\_shares\_sold": 25000,
"reported\_shares\_after\_sale": 12000,
"reported\_sale\_ratio\_pct": 67.57,
"transaction\_count": 1,
"under\_10b5\_1\_plan": false,
"why\_it\_matters": "Example Executive (Chief Executive Officer) at Example Corporation reported approximately $5,400,000 of open-market stock sales. This appears to be the first major sale detected in the previous 12 months.",
"source": "SEC EDGAR",
"source\_url": "https://www.sec.gov/Archives/..."
}

### Potential use cases

- Wealth management prospecting
- Private banking research
- Executive financial planning
- Tax advisory prospecting
- Estate-planning research
- Sales intelligence
- Market intelligence
- Insider-activity monitoring
- AI agents consuming structured financial-event data

### Data source

Source data comes from official SEC EDGAR public filings.

The Actor uses HTTP requests only.

It does not require browser automation, proxies, or paid third-party data providers.

### Important limitations

A liquidity signal does not prove that an individual:

- needs financial advice
- intends to move assets
- is seeking a wealth manager
- represents a qualified sales lead

Reported holdings in SEC filings may not represent the insider's complete economic ownership.

Historical analysis is intentionally limited and should be interpreted as a screening signal rather than a complete behavioral profile.

Entity detection is heuristic and may occasionally misclassify a reporting owner.

### Disclaimer

This Actor provides structured public-data intelligence.

It does not provide investment, financial, legal, tax, compliance, or suitability advice..

# Actor input Schema

## `maxFilingsToScan` (type: `integer`):

Maximum number of recent Form 4 filings to analyze. Higher values provide broader coverage but take longer to process.

## `maxResults` (type: `integer`):

Maximum number of qualified executive liquidity signals to return.

## `minTransactionValueUsd` (type: `integer`):

Ignore insider stock-sale events with an estimated total value below this amount.

## `minLiquidityScore` (type: `integer`):

Only return signals meeting this minimum score. Use 50 for broader discovery, 70 for HIGH or stronger signals, and 85 for CRITICAL signals.

## Actor input object example

```json
{
  "maxFilingsToScan": 40,
  "maxResults": 5,
  "minTransactionValueUsd": 100000,
  "minLiquidityScore": 50
}
```

# Actor output Schema

## `results` (type: `string`):

Filtered and scored executive liquidity events detected from official SEC filings.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("abundancewoman/sec-executive-liquidity-signals").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("abundancewoman/sec-executive-liquidity-signals").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call abundancewoman/sec-executive-liquidity-signals --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abundancewoman/sec-executive-liquidity-signals"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/L42PCbzU1dYt2fvhs/builds/ioqfDgV2Clrj8sw6T/openapi.json