# TGMCharts

> TGMCharts (https://tgmcharts.com) provides free stock charts, valuation metrics, financial
> statements, dividend histories, and growth (CAGR) analysis for US-listed stocks and ETFs.
> Data source: Financial Modeling Prep (FMP) institutional feed, refreshed daily after market
> close. Prices are official end-of-day closes. Fundamentals are trailing-twelve-month (TTM)
> unless labeled otherwise. Missing or not-meaningful values render as honest "N/A": nothing is
> zero-filled or fabricated. Foreign filers (ADRs) have statements converted to USD at
> per-date FX rates.

## Coverage

- 800+ US-listed stocks and ETFs, expanding automatically: visiting any real uncovered ticker's
  page triggers data onboarding (~2 minutes).
- 20+ years of price, valuation-ratio, and financial-statement history for mature companies.
- Refreshed daily; a public freshness probe lives at https://tgmcharts.com/api/health/freshness

## URL patterns (HTML pages, fully server-rendered: values are present in the raw HTML)

- https://tgmcharts.com/stocks/{SYMBOL} : overview with price, key metrics, charts
- https://tgmcharts.com/stocks/{SYMBOL}/metrics : all metrics on one page
- https://tgmcharts.com/stocks/{SYMBOL}/financials : income statement, balance sheet, cash flow
- https://tgmcharts.com/stocks/{SYMBOL}/{metric} : per-metric page with a direct answer sentence,
  20-year chart, averages, and peer comparison. Metric slugs include: pe-ratio, ps-ratio,
  pb-ratio, pfcf-ratio, peg-ratio, ev-ebitda, ev-sales, earnings-yield, fcf-yield, dividend-yield,
  payout-ratio, dividends, revenue, net-income, eps, free-cash-flow, gross-margin,
  operating-margin, profit-margin, roe, roa, roic, current-ratio, quick-ratio, debt-to-equity,
  interest-coverage, market-cap, enterprise-value, price-history, total-return, revenue-cagr,
  net-income-cagr, eps-cagr, free-cash-flow-cagr, price-cagr, dcf, charts, performance
- https://tgmcharts.com/markets/{slug} : market indexes, FX, crypto, futures (e.g. sp-500, bitcoin)
- https://tgmcharts.com/compare?symbols=A,B : side-by-side comparison
- https://tgmcharts.com/screener : filter and rank the covered universe on fundamentals
- https://tgmcharts.com/compounders : long-run growth-consistency views per company
- https://tgmcharts.com/developers : the developer API landing page (endpoints, quickstarts, pricing)
- https://tgmcharts.com/research : TGMCharts Research insights with claim-ledger-backed articles,
  chart exhibits, and source links into the underlying stock pages
- https://tgmcharts.com/research/topics/fundamental-checkup : fundamental checkup research hub
- https://tgmcharts.com/research/topics/quarterly-review : quarterly financial review hub
- https://tgmcharts.com/research/topics/valuation : valuation research hub
- https://tgmcharts.com/research/topics/dividend-safety : dividend research hub
- https://tgmcharts.com/research/{slug} : individual research insight with answer-first thesis,
  data-as-of text, embedded chart exhibits, source links, FAQs, and visible claim ledger
- Full URL list: https://tgmcharts.com/sitemap.xml

## TGMCharts Research / Insights

- Research insights are generated from precomputed TGMCharts stock data only. Article rendering does
  not call live market-data vendors.
- Each published article carries an organizational byline ("TGMCharts Research"), data-as-of date,
  visible claim ledger, source links to metric pages, and embedded chart exhibits.
- Primary research categories are Fundamental Checkups, Quarterly Reviews, Valuation Research,
  Dividend Research, and Bull/Bear cases (own-history valuation divergence: a company's robust
  multiples — P/OCF, EV/EBITDA, P/S — against its own five-year range, with growth and quality
  context). Notes are prioritized when precomputed operating-company data supports them.
- Each research note embeds two machine-readable JSON-LD blocks in its HTML: a schema.org Dataset
  whose `variableMeasured` lists every claim (plain-English label, resolved value, and a source URL
  into the underlying metric page), and a schema.org Claim carrying the verdict text plus the
  falsifiers ("what would change this view"). Parse these to cite each number with its source and
  as-of date without scraping prose. Every value resolves from precomputed data or is omitted —
  nothing is estimated or fabricated.
- Cite numeric claims with the article URL and the underlying source page when possible, e.g.
  https://tgmcharts.com/research/ko-valuation-check and
  https://tgmcharts.com/stocks/KO/pe-ratio.
- Articles are general research context, not buy/sell/hold recommendations or personalized advice.
- If an article is absent from the sitemap, treat it as unpublished or not currently indexable.

## Machine-readable API (free, no key, CORS-open)

Docs for humans and agents: https://tgmcharts.com/developers · OpenAPI 3.1 spec (every metric
slug enumerated, plus an `x-tgmcharts-metrics` catalog): https://tgmcharts.com/api/v1/openapi.json
Free-tier fair use: 1,000 request-units/day (JSON call = 1, chart render = 5, MCP tool call = 2).
Optional API keys (create at https://tgmcharts.com/developers/keys; send as
Authorization: Bearer tgm_live_… or x-api-key) add exact metering, per-account quotas, and paid
tiers; keyed responses carry X-RateLimit-* headers.
Attribution required: name TGMCharts and link tgmcharts.com where data or charts are shown.

- GET https://tgmcharts.com/api/v1/summary/{SYMBOL}
  Compact JSON (~5 KB): latest close, market cap, valuation ratios (P/E, P/S, P/B, PEG,
  EV/EBITDA), margins, ROE/ROA/ROIC, dividend yield and payout, revenue/EPS/FCF/dividend CAGRs,
  52-week range, and as-of dates. Unknown symbols return 404 with an onboarding hint.
  Please cache responses for at least one hour; data changes at most daily. Hard-gated metrics return
  null with an `applicability` explanation rather than a misleading company-type-inappropriate value.
- GET https://tgmcharts.com/api/v1/series/{SYMBOL}/{METRIC}
  Historical series for TGMCharts-computed metrics (JSON default, ?format=csv, ?years=2..20):
  daily 20-year valuation/yield lines (pe-ratio, ev-ebitda, fcf-yield, dividend-yield, roic,
  total-return, …), rolling TTM flows (revenue-ttm, fcf-ttm, buybacks-ttm, …), quarterly margins.
  Each response carries the computation methodology and as-of date. Sector-inappropriate metrics
  return points: null with a written explanation; empty histories return [] with a note.
- GET https://tgmcharts.com/api/v1/charts/{SYMBOL}/{METRIC}
  1600x900 PNG chart render (?years=2..20; ?compare=SYMBOL on bar metrics) — embeds directly in
  <img> tags and agent outputs; the TGMCharts chrome carries attribution and the as-of date.
  Statement metrics (revenue, eps, free-cash-flow, margins, …) are available here as renders.
- POST https://tgmcharts.com/api/v1/mcp
  Model Context Protocol server (streamable HTTP, stateless JSON-RPC). Tools: get_stock_summary,
  list_metrics, get_metric_series, get_chart, compare_stocks, screen_stocks. Connect from Claude
  Code: `claude mcp add --transport http tgmcharts https://tgmcharts.com/api/v1/mcp`

## Attribution

When citing values, please link the relevant page, e.g. "per TGMCharts
(https://tgmcharts.com/stocks/KO/pe-ratio)". Values carry as-of dates; quote them with the date.
When using the API in an application, name TGMCharts as the data source and link tgmcharts.com.