← Back to Skills Marketplace
🔌

SEC Filings

by Lovelace AI · GitHub ↗ · v1.0.0-beta.1 · MIT-0
cross-platform ⚠ suspicious
57
Downloads
1
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install sec-filings
Description
Query SEC filings for any public company by name, ticker, or CIK. (Beta)
README (SKILL.md)

Use curl to call the endpoint below. Server runs at https://labs.lovelace.ai/sec/api. Every request requires entity (company name, ticker, or CIK).

/filings — list SEC filings

# By company name
curl "https://labs.lovelace.ai/sec/api/filings?entity=Apple&form_types=10-K&limit=4"

# By ticker
curl "https://labs.lovelace.ai/sec/api/filings?entity=TSLA&limit=5"

# By CIK
curl "https://labs.lovelace.ai/sec/api/filings?entity=320193"

# With date range (both bounds inclusive, YYYY-MM-DD)
curl "https://labs.lovelace.ai/sec/api/filings?entity=Microsoft&form_types=10-K,10-Q&after=2023-01-01"
curl "https://labs.lovelace.ai/sec/api/filings?entity=Microsoft&form_types=10-K&after=2020-01-01&before=2022-12-31"

# Markdown output
curl -H "Accept: text/markdown" "https://labs.lovelace.ai/sec/api/filings?entity=Apple&form_types=10-K&limit=3"

Parameters

Param Required Description
entity yes Company name, ticker symbol, or CIK (max 256 chars)
form_types no Comma-separated list. Omit for all supported types.
limit no Max results (default 10, max 50)
after no Inclusive lower bound on filing date, YYYY-MM-DD
before no Inclusive upper bound on filing date, YYYY-MM-DD

Valid form types

Use these values in form_types to narrow results. Omit to return all types.

Value What it is When to use
10-K Annual Report Full-year financial results, risk factors, business overview
10-Q Quarterly Report Quarterly financials and updates between annual reports
8-K Current Report Material events: earnings releases, M&A, leadership changes, etc.
4 Insider Ownership Changes Trades or grants of shares by officers, directors, or 10%+ holders
SC 13D Activist Stake Disclosure Filed when an investor acquires >5% with intent to influence the company
SC 13G Passive Stake Disclosure Filed when an investor acquires >5% passively (no influence intent)
13F-HR Institutional Holdings Quarterly snapshot of a fund's equity holdings (≥$100M AUM required)
DEF 14A Proxy Statement Shareholder meeting agenda: board elections, exec pay, governance votes

Response

JSON object with a filings array. Results are sorted most-recent first.

Field Description
form_type Filing type (e.g. 10-K, 8-K)
date Filing date (YYYY-MM-DD)
accession_number SEC accession number
cik Company CIK
description Human-readable filing description
edgar_url Direct link to the filing index on SEC EDGAR
{
  "filings": [
    {
      "form_type": "10-K",
      "date": "2024-11-01",
      "accession_number": "0000320193-24-000123",
      "cik": "320193",
      "description": "Annual Report (Form 10-K)",
      "edgar_url": "https://www.sec.gov/Archives/edgar/data/320193/000032019324000123/0000320193-24-000123-index.htm"
    }
  ]
}

Add -H "Accept: text/markdown" for a human-readable markdown list instead of JSON.

Example prompts

These prompts work well with this skill:

  • "Show me Apple's last 3 annual reports"
  • "What 8-Ks has Tesla filed in the last 90 days?"
  • "Find all insider trades at Nvidia since January"
  • "Who are the large passive shareholders of Microsoft? Show me their SC 13G filings"
  • "Pull Berkshire Hathaway's last two proxy statements"
  • "Has Amazon made any material event disclosures this quarter?"

Errors

HTTP status Meaning
400 Bad request — missing entity, invalid after/before format, or unrecognised form_types
404 Entity not found — try a different name, the ticker symbol, or the CIK
500 Internal error — retry once; if it persists the server may be unavailable
503 Server starting up — retry after a few seconds

By using this skill you agree to the Lovelace AI Terms and Conditions.

Usage Guidance
This skill is reasonable to install if you are comfortable with Lovelace receiving your SEC filing search terms. Do not include private or confidential information in queries, and ensure generated curl requests safely encode user-provided values.
Capability Analysis
Type: OpenClaw Skill Name: sec-filings Version: 1.0.0-beta.1 The skill facilitates SEC filing searches by instructing the agent to use `curl` to access a third-party API (`labs.lovelace.ai`) in `SKILL.md`, which involves shell-based network access and potential shell injection vulnerabilities if parameters are not sanitized. While the functionality is aligned with the stated purpose, the use of an external intermediary and the presence of an anomalous future-dated timestamp (2026) in `_meta.json` are flagged as risky indicators under the provided guidelines.
Capability Assessment
Purpose & Capability
The described purpose is to query public SEC filings, and the artifacts only document read-only filing lookup requests.
Instruction Scope
The skill instructs the agent to use curl with a user-supplied company name, ticker, or CIK; this is purpose-aligned, but the agent should URL-encode inputs and avoid treating user text as shell syntax.
Install Mechanism
There is no install script or bundled executable code; the only declared requirement is the curl binary.
Credentials
The skill makes network requests to https://labs.lovelace.ai/sec/api, which is disclosed and proportionate for a hosted SEC lookup service.
Persistence & Privilege
The artifacts show no credentials, persistence, background activity, local file access, account mutation, or elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install sec-filings
  3. After installation, invoke the skill by name or use /sec-filings
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0-beta.1
Initial beta release. Query recent and historical SEC filings by company name, ticker, or CIK. - Search for filings (10-K, 10-Q, 8-K, insider trades, proxy statements, etc.) using simple curl requests. - Filter results by filing type and date range. - Output results in JSON or Markdown format. - Includes sample queries and detailed usage instructions. - Beta version—feedback welcome!
Metadata
Slug sec-filings
Version 1.0.0-beta.1
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is SEC Filings?

Query SEC filings for any public company by name, ticker, or CIK. (Beta). It is an AI Agent Skill for Claude Code / OpenClaw, with 57 downloads so far.

How do I install SEC Filings?

Run "/install sec-filings" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is SEC Filings free?

Yes, SEC Filings is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does SEC Filings support?

SEC Filings is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created SEC Filings?

It is built and maintained by Lovelace AI (@lovelaceai); the current version is v1.0.0-beta.1.

💬 Comments