Developer API
Documentation
Reference docs for the TGMCharts stock fundamentals API: summary, series, chart-image and SEC statement endpoints, MCP server, keys and pricing, data lineage.
Every endpoint reads stored, precomputed data — no request waits on a live market-data call — and missing or not-meaningful values are honest nulls with a written reason, never zero-filled. REST reads are keyless and CORS-open; MCP tool calls take a free key.
Documentation updated 2026-09-02. Machine-readable: openapi.json · llms.txt
Topics
Stock summary endpoint
Compact JSON summary of a stock's fundamentals: latest close, valuation ratios, margins, dividends, growth CAGRs, as-of dates, honest nulls. Keyless, CORS-open.
Read →Metric series endpoint
Metric history as JSON or CSV: daily 20-year valuation lines, rolling TTM flows, quarterly margins, SEC-filed statement metrics. Methodology on every response.
Read →Chart image endpoint
Embed 1600×900 PNG charts of stock fundamentals with one URL: revenue, EPS, margins, daily P/E and other valuation lines, attribution and as-of date in frame.
Read →Financial statements endpoint
Income statement, balance sheet and cash flow as filed with the SEC: JSON or CSV from EDGAR XBRL company facts with per-value provenance (tag, accession, date).
Read →MCP server for AI agents
Connect Claude Code or any MCP client to stock fundamentals: seven tools for summaries, metric histories, chart URLs, SEC statements, comparisons and screening.
Read →Authentication, rate limits and pricing
API keys, request units, tier quotas, X-RateLimit headers and the 401/429 bodies, with free and paid tiers, included units, prices and attribution rules.
Read →Data quality and lineage
Where each API value comes from: valuation series precomputed daily from licensed market data, statements from SEC EDGAR XBRL as filed. Null vs zero, freshness.
Read →Quickstarts
Copy-paste examples for the stock fundamentals API: curl, Python requests and pandas, Node fetch, a Claude Code MCP walkthrough, an OpenAI tool from OpenAPI.
Read →Endpoints at a glance
Base URL https://tgmcharts.com. Symbols are US-listed tickers (800+ covered, self-onboarding).
| Method | Path | Returns | Docs |
|---|---|---|---|
| GET | /api/v1/summary/{symbol} | Compact per-stock fundamentals summary (JSON) | Summary |
| GET | /api/v1/series/{symbol}/{metric} | Metric history as JSON or CSV | Series |
| GET | /api/v1/charts/{symbol}/{metric} | 1600×900 PNG chart render | Charts |
| GET | /api/v1/statements/{symbol}/{statement} | SEC-filed statements with per-value provenance | Statements |
| POST | /api/v1/mcp | MCP server (streamable HTTP) for AI agents | MCP server |
| GET | /api/v1/openapi.json | OpenAPI 3.1 document with the full metric catalogue | Quickstarts |
First call
No key, no signup. Cache responses for at least an hour — the data changes at most daily — and name TGMCharts with a link to tgmcharts.com wherever the data or charts are shown.
curl -s https://tgmcharts.com/api/v1/summary/AAPLclaude mcp add --transport http tgmcharts https://tgmcharts.com/api/v1/mcp