sec-edgar

Resolve U.S. equity tickers to CIK identifiers and retrieve SEC EDGAR filing data.

Updated Jul 8, 2026
One-click install
npx skills add https://github.com/hxhyyy/Vibe-Trading --skill sec-edgar-hxhyyy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sec-edgar
Source: https://github.com/hxhyyy/Vibe-Trading/tree/main/agent/src/skills/sec-edgar
Command: npx skills add https://github.com/hxhyyy/Vibe-Trading --skill sec-edgar-hxhyyy

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This skill eliminates the manual effort of navigating the SEC EDGAR website, resolving tickers to CIKs, and parsing complex XBRL filings, providing a streamlined interface for financial data retrieval.

Core Features & Use Cases

  • Ticker-to-CIK Resolution: Automatically maps U.S. equity symbols to their official SEC Central Index Key.
  • Filing Retrieval: Fetches recent 10-K, 10-Q, and 8-K filings with direct links to primary documents.
  • Financial Metrics: Extracts structured XBRL us-gaap financial series like Revenues or Net Income for historical analysis.
  • Use Case: Use this skill to pull the last five years of revenue data for a specific company to perform a quick trend analysis without leaving your agent environment.

Quick Start

Use the get_sec_filings tool to fetch the five most recent 10-K filings for Apple Inc.

Frequently Asked Questions about sec-edgar

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve SEC EDGAR financial data using a stock ticker?

To retrieve SEC EDGAR financial data, you resolve a U.S. equity ticker to its official CIK identifier, then fetch structured XBRL filings like 10-K or 10-Q reports. This provides programmatic access to official company submissions and financial statements.

How do I extract XBRL financial metrics from SEC filings for historical analysis?

You extract XBRL financial metrics by retrieving structured SEC EDGAR filing data, which parses complex XBRL us-gaap financial series like Revenues or Net Income. This allows you to pull multiple years of data for historical trend analysis.

Can I fetch 10-K and 8-K filings from SEC EDGAR programmatically?

Yes, you can fetch 10-K, 10-Q, and 8-K filings programmatically. The process retrieves recent SEC EDGAR submissions and provides direct links to primary documents within standardized JSON envelopes for easy integration.

Does accessing SEC EDGAR data require a specific User-Agent to avoid throttling?

Yes, compliant SEC EDGAR data fetching requires a descriptive User-Agent to satisfy throttling requirements. Operating within the U.S. market scope, it ensures programmatic access to official company submissions remains uninterrupted and compliant.

What is the best way to map U.S. equity symbols to SEC Central Index Keys?

The best way to map U.S. equity symbols to SEC Central Index Keys is through automated ticker-to-CIK resolution. This eliminates manual effort by directly translating standard stock tickers into their official SEC EDGAR identifiers.