macrotrends

Scrapes financial statements, ratios, and employee counts from Macrotrends without an API key.

Updated Aug 13, 2026
One-click install
npx skills add https://github.com/Martino17x/Sentinel-Invest --skill macrotrends-martino17x
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: macrotrends
Source: https://github.com/Martino17x/Sentinel-Invest/tree/main/.agents/skills/macrotrends
Command: npx skills add https://github.com/Martino17x/Sentinel-Invest --skill macrotrends-martino17x

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve? Accessing historical financial data for US-listed stocks usually requires paid APIs or manual copy-pasting from websites. This Skill extracts income statements, balance sheets, cash flow statements, financial ratios, and employee counts directly from Macrotrends, covering 15+ years of history for roughly 6,500 tickers without any API key. ## Core Features & Use Cases - Full Financial Statements: Fetch income statements, balance sheets, and cash flow data in annual or quarterly frequency (where available) with 22-29 fields per statement. - Financial Ratios & Employee Counts: Retrieve 20 precomputed ratios (ROE, margins, debt/equity) plus year-by-year employee headcount. - ADR Coverage: Works with international ADRs like GGAL, BABA, or TM, with automatic ticker-to-slug resolution and a manual slug fallback. - Use Case: Run a single command to pull all of NVIDIA's annual financials into a JSON file, then feed it into your valuation model or dashboard. ## Quick Start Ask the AI to fetch Apple's complete financial data by running the fetch_financials.py script with the ticker AAPL and the --all flag, saving the output to a JSON file.

Frequently Asked Questions about macrotrends

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

FAQPage Schema
How do I scrape financial statements from Macrotrends with Python?▼

Run the fetch_financials.py script with a ticker and data flags, for example --ticker NVDA --income for the income statement or --all for everything. The script extracts JSON embedded in Macrotrends pages using requests and BeautifulSoup, no API key needed.

What financial data can I get from Macrotrends?▼

You can retrieve income statements (22 fields), balance sheets (23 fields), cash flow statements (29 fields), 20 financial ratios, and annual employee counts. Most data is available annually for about 15 years and quarterly for about 60 quarters, except cash flow which is annual only.

Does Macrotrends data cover international stocks?▼

Macrotrends covers about 6,500 tickers on NYSE, NASDAQ, and AMEX, including 276+ international ADRs like GGAL, BABA, and TM. Stocks listed only on foreign exchanges without a US ADR, such as SAP.DE or 005930.KS, are not available.

Why am I getting 429 Too Many Requests errors when scraping?▼

Macrotrends rate-limits rapid requests, returning HTTP 429. Increase the --delay parameter to at least 3 seconds between requests, limit runs to about 5-6 tickers, and wait 30-60 seconds before retrying after a 429 response.

What do I do when the ticker slug is not found?▼

If automatic slug resolution fails, pass the slug manually with the --slug flag, for example --slug grupo-financiero-galicia-sa for GGAL. You can find slugs by querying the Macrotrends ticker search endpoint directly.