US Market Data Toolkit
Geeksfino/finskills
Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.
Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.
$ npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install HKUDS/Vibe-Trading sec-edgar --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .claude/skills && cp -r skills-src/agent/src/skills/sec-edgar .claude/skills/sec-edgar && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "sec-edgar" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgar into .claude/skills/sec-edgar/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-edgar", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgarType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install HKUDS/Vibe-Trading sec-edgar --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .agents/skills && cp -r skills-src/agent/src/skills/sec-edgar .agents/skills/sec-edgar && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "sec-edgar" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgar into .agents/skills/sec-edgar/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-edgar", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install HKUDS/Vibe-Trading sec-edgar --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/agent/src/skills/sec-edgar .cursor/skills/sec-edgar && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "sec-edgar" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgar into .cursor/skills/sec-edgar/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-edgar", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/HKUDS/Vibe-Trading.git --path agent/src/skills/sec-edgar--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install HKUDS/Vibe-Trading sec-edgar --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/agent/src/skills/sec-edgar .gemini/skills/sec-edgar && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "sec-edgar" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgar into .gemini/skills/sec-edgar/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-edgar", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install HKUDS/Vibe-Trading sec-edgarInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .github/skills && cp -r skills-src/agent/src/skills/sec-edgar .github/skills/sec-edgar && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "sec-edgar" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgar into .github/skills/sec-edgar/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-edgar", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install HKUDS/Vibe-Trading sec-edgar --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/HKUDS/Vibe-Trading.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/agent/src/skills/sec-edgar .opencode/skills/sec-edgar && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "sec-edgar" agent skill from https://github.com/HKUDS/Vibe-Trading/tree/main/agent/src/skills/sec-edgar into .opencode/skills/sec-edgar/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "sec-edgar", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
sec-edgarFetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series.
The skill covers the free, no-key SEC EDGAR endpoints for U.S. reporting companies: a ticker-to-CIK directory, a recent-filings index and the XBRL company facts a firm has reported. The preferred path is the read-only, throttled `get_sec_filings` tool, which takes a ticker, an optional form type and limit, and an optional metric such as Revenues, and returns strict JSON.
When the tool does not expose what you need, such as a company address or every unit of a concept, the `sec_edgar_client` functions `cik_for`, `get_submissions` and `get_company_facts` return raw JSON, and a runnable example script is included. Requests are throttled and carry a contact User-Agent because EDGAR limits by IP. Coverage is United States only, so other markets go to other data skills, and a separate `edgar-sec-filings` skill handles how to read the filings.
Read from SKILL.md and the folder at commit e532650. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Ships 1 file in scripts/ (Python), which the agent can run.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
SEC EDGAR Filings Fetcher loads about 1.4k tokens when it runs, and up to ~4.6k if it reads all its reference files. Until then it costs about 79 tokens; SKILL.md has 630 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.
The full file from HKUDS/Vibe-Trading at commit e532650, republished under its MIT licence (© HKUDS). 630 words, ~1,416 tokens.
.claude/skills/sec-edgar/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.The U.S. Securities and Exchange Commission (SEC) publishes free, no-auth JSON endpoints for every reporting company on its EDGAR system: a ticker-to-CIK directory, a recent-filings index, and the full set of XBRL ("companyfacts") financial concepts a company has reported. This skill documents how Vibe-Trading fetches that data through the bundled sec_edgar_client transport and the get_sec_filings agent tool.
This is the fetch skill — it covers how to get filing-index rows, document URLs, and us-gaap metric series out of EDGAR. The separate edgar-sec-filings skill is the methodology layer (how to read a 10-K, score insider activity, interpret 8-K items); for any actual data retrieval it delegates here.
Scope is the United States only. EDGAR has no coverage of A-shares, HK, or other non-U.S. markets — route those through tushare / yfinance / akshare instead.
Link convention: every link below that points into
references/is written relative to this document (references/...) — the form GitHub resolves when someone opens the file in a browser. Theread_filetool resolves the same string against the skill that owns it, so the agent and a human reader reach one file. Keep the relative form when adding new docs, and keep reference paths unique across skills: a path two skills both carry is reported as ambiguous rather than guessed.
Preferred path — the get_sec_filings tool (read-only, throttled, returns strict JSON):
{ "ticker": "AAPL", "form": "10-K", "limit": 5 }{ "ticker": "MSFT", "metric": "Revenues", "limit": 8 }The tool resolves the ticker to a CIK, fetches the filing index (optionally filtered by form), and — when metric is set — also pulls the XBRL series for that us-gaap concept. See sec-edgar/references/get_sec_filings_tool.md for the full parameter and envelope contract.
Script path — call the sec_edgar_client transport directly when you need raw JSON the tool does not surface (e.g. company address, all units of a concept):
from backtest.loaders.sec_edgar_client import cik_for, get_submissions, get_company_facts
cik = cik_for("AAPL") # "0000320193", or None if not in the SEC table
submissions = get_submissions(cik) # recent-filings index + company metadata
facts = get_company_facts(cik) # all reported XBRL conceptsA runnable end-to-end example lives at sec-edgar/scripts/sec_filings_example.py.
AAPL, msft). Resolved to a CIK via the SEC company-tickers table; an unlisted ticker returns an error envelope (tool) or None (cik_for).320193 → "0000320193"). The submissions and companyfacts endpoints require the padded form; document URLs use the un-padded form.10-K, 10-Q, 8-K, DEF 14A, 4). Omit to return all recent forms.us-gaap concept name (Revenues, NetIncomeLoss, Assets, StockholdersEquity). Case-sensitive — these are exact taxonomy element names.YYYY-MM-DD strings (e.g. 2023-09-30).dict).cik_for, get_submissions, get_company_facts, CIK padding, throttle bucket, contact User-Agent.filings[] and metric field shapes.User-Agent carrying a contact address; the client ships a compliant default and honors the VIBE_TRADING_SEC_UA override.backtest.loaders._http throttle under the "sec" host bucket (≈0.12s spacing floor, overridable via VIBE_TRADING_SEC_MIN_INTERVAL). Do not bypass the client with raw requests loops.sec_edgar_client is a thin REST client, not a DataLoaderProtocol. There is no source: "sec_edgar" backtest mode — EDGAR feeds the get_sec_filings tool, not the bar-loading layer.edgar-sec-filings methodology skill.© HKUDS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 5 other files (scripts, references) in agent/src/skills/sec-edgar of HKUDS/Vibe-Trading.
Open the folder on GitHubat commit e532650
SEC EDGAR Filings Fetcher next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| SEC EDGAR Filings Fetcher this skillHKUDS/Vibe-Trading | 35k | — | ~1.4k | Automated safety check: Pass | MIT | |
| US Market Data ToolkitGeeksfino/finskills | 283 | — | ~1.2k | Automated safety check: Pass | Apache-2.0 | |
| A-Share Daily Reviewqusong0627/QuantMind | 1.7k | — | ~1.9k | Automated safety check: Pass | AGPL-3.0 | |
| Financial Researchfirecrawl/web-agent | 1.2k | — | ~1.1k | Automated safety check: Pass | MIT | |
| Senpi Market PulseSenpi-ai/senpi-skills | 134 | — | ~4.3k | Automated safety check: Pass | Apache-2.0 | |
| Stock Deep Analysis Workflowwbh604/UZI-Skill | 7.1k | — | ~9.1k | Automated safety check: Notes | MIT |
Geeksfino/finskills
Free Python scripts that fetch US stock data, SEC filings, insider trades and macro indicators, and run financial score calculators and portfolio analytics.
qusong0627/QuantMind
Produces a post-market review report for the China A-share market from local QuantDB data, news sentiment and model signals, ending in a next-day direction call.
firecrawl/web-agent
Pulls a public company's latest 10-K or 10-Q figures and analyst consensus from SEC EDGAR and Yahoo Finance, then cross-checks the two sources.
Senpi-ai/senpi-skills
Produces a structured cross-asset read of the day across crypto, equities, indices, commodities and macro, using a bundled engine for data and ending with a signals brief.
wbh604/UZI-Skill
Runs a staged deep analysis of a single stock on China A-share, Hong Kong and US markets, ending in an HTML report with valuation models and investor-panel scores.
xbtlin/ai-berkshire
Scans a long-running industry trend for supply chain chokepoints, aiming to find second- and third-layer suppliers that the market has not yet priced in.
HKUDS/Vibe-Trading
Index of Eastmoney's free, no-token market data interfaces for China A-shares and Hong Kong stocks: fund flows, dragon-tiger lists, margin trading, reports and news.
HKUDS/Vibe-Trading
Retrieves public OKX cryptocurrency market data such as spot prices, candlesticks, funding rates and open interest through the OKX V5 REST API, with no authentication.
HKUDS/Vibe-Trading
Predicts whether a mainland China A-share company risks an ST or *ST warning after its next annual report, using financial thresholds and Sina penalty records.
HKUDS/Vibe-Trading
Breaks a structural trend such as AI infrastructure into its physical supply chain and ranks lesser-known listed companies sitting on each bottleneck.
HKUDS/Vibe-Trading
Plans and drafts an eight-part, roughly 120k-word investigative series on one company, built around a strict fact-check pass rather than fast drafting.
HKUDS/Vibe-Trading
Keeps a written investment thesis for each stock you hold and re-checks it every quarter against new earnings, scoring its health and recommending hold, add, trim or exit.
Categories
Fetches U.S. SEC EDGAR data: resolves tickers to CIK numbers, lists recent 10-K, 10-Q and 8-K filings with document URLs, and pulls XBRL financial series. S. reporting companies: a ticker-to-CIK directory, a recent-filings index and the XBRL company facts a firm has reported.
SEC EDGAR Filings Fetcher fits situations like: looking up the most recent 10-K or 10-Q filings for a ticker; pulling a revenue or other us-gaap series from XBRL company facts; getting the primary-document URL for a specific filing; resolving a ticker symbol to its CIK.
Run `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a claude-code`. Or copy the skill folder (agent/src/skills/sec-edgar in HKUDS/Vibe-Trading) into .claude/skills/sec-edgar in your project. Claude Code loads it when a task matches its description.
Run `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a codex`. Or copy the skill folder (agent/src/skills/sec-edgar in HKUDS/Vibe-Trading) into .agents/skills/sec-edgar in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add HKUDS/Vibe-Trading --skill sec-edgar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sec-edgar, .gemini/skills/sec-edgar, .github/skills/sec-edgar and .opencode/skills/sec-edgar in your project.
Going by SKILL.md and its folder, SEC EDGAR Filings Fetcher needs Python for the scripts in its folder. Our summary lists: Network access to SEC EDGAR; Python for the `sec_edgar_client` functions.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.
SEC EDGAR Filings Fetcher is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.2k tokens, read only when the agent opens those files.
Skills that share tags, products or a category with SEC EDGAR Filings Fetcher: US Market Data Toolkit (Geeksfino/finskills, 283 stars), A-Share Daily Review (qusong0627/QuantMind, 1.7k stars), Financial Research (firecrawl/web-agent, 1.2k stars) and Senpi Market Pulse (Senpi-ai/senpi-skills, 134 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
HKUDS (a GitHub organization) maintains it in HKUDS/Vibe-Trading, which has 35,043 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 8, 2026.
Source: HKUDS/Vibe-Trading on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.