Stock Analysis API: Get key statistics
Looks up a stock by company name or ticker on Stock Analysis and returns its valuation ratios and company statistics, with the date the figures were last updated.
Unofficial. Not affiliated with or endorsed by Stock Analysis.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Company, required
company Company name or stock ticker, for example Nvidia or NVDA.
Nvidia
Input as JSON
{ "company": "Nvidia"}Output
{ "beta": 2.216, "price": 212.21, "ticker": "NVDA", "company": "NVIDIA Corporation", "currency": "USD", "exchange": "NASDAQ", "pe_ratio": 26.833, "employees": 42000, "as_of_date": "2026-10-23", "market_cap": 5124234870000, "ev_to_ebitda": 25.34, "price_to_book": 22.378, "price_to_sales": 16.913, "enterprise_value": 5100625870000, "forward_pe_ratio": 17.546, "shares_outstanding": 24147000000, "stock_analysis_link": "https://stockanalysis.com/stocks/nvda/statistics/" , "dividend_yield_percent": 0.471}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"stockanalysis.com/get_key_statistics","input":{"company":"Nvidia"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "stockanalysis.com/get_key_statistics" , "input": { "company": "Nvidia" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "stockanalysis.com/get_key_statistics" , "input": { "company": "Nvidia" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run stockanalysis.com/get_key_statistics# with {"company":"Nvidia"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "company" ], "properties": { "company": { "type": "string", "description": "Company name or stock ticker, for example Nvidia or NVDA." } }}Output schema
{ "type": "object", "required": [ "company", "ticker", "exchange", "currency", "price", "market_cap", "enterprise_value", "pe_ratio", "forward_pe_ratio", "price_to_sales", "price_to_book", "ev_to_ebitda", "dividend_yield_percent", "beta", "shares_outstanding", "employees", "as_of_date", "stock_analysis_link" ], "properties": { "beta": { "type": [ "number", "null" ], "description": "Five-year stock beta." }, "price": { "type": [ "number", "null" ], "description": "Stock price in the stated currency." }, "ticker": { "type": "string", "description": "Stock ticker." }, "company": { "type": "string", "description": "Company name." }, "currency": { "type": "string", "description": "Currency code of prices and company values." }, "exchange": { "type": "string", "description": "Stock exchange." }, "pe_ratio": { "type": [ "number", "null" ], "description": "Trailing price-to-earnings ratio." }, "employees": { "type": [ "number", "null" ], "description": "Employee count." }, "as_of_date": { "type": "string", "format": "date", "description": "Date the figures were last updated, YYYY-MM-DD." }, "market_cap": { "type": [ "number", "null" ], "description": "Market capitalization in full currency units." }, "ev_to_ebitda": { "type": [ "number", "null" ], "description": "Enterprise value to EBITDA ratio." }, "price_to_book": { "type": [ "number", "null" ], "description": "Price-to-book ratio." }, "price_to_sales": { "type": [ "number", "null" ], "description": "Price-to-sales ratio." }, "enterprise_value": { "type": [ "number", "null" ], "description": "Enterprise value in full currency units." }, "forward_pe_ratio": { "type": [ "number", "null" ], "description": "Forward price-to-earnings ratio." }, "shares_outstanding": { "type": [ "number", "null" ], "description": "Number of shares outstanding." }, "stock_analysis_link": { "type": "string", "format": "uri", "description": "Stock Analysis statistics page link." }, "dividend_yield_percent": { "type": [ "number", "null" ], "description": "Annual dividend yield as a percent, null when none." } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
stockanalysis.com/get_key_statistics- Returns
- company, ticker, exchange, currency, price, market cap, enterprise value, valuation ratios, beta, shares, employees, update date, link
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method stockanalysis.com/get_key_statistics with the inputs above.
Ask your agent
- What is Nvidia's current P/E ratio and market cap?
- Show me the valuation ratios and beta for NVDA.
- How many employees does Apple have and what is its enterprise value?
- I need the key statistics for Tesla, including shares outstanding and price-to-book, on stockanalysis.com.
- When were Microsoft's financial statistics like EV/EBITDA last updated?
See more
All Stock Analysis methodsLooks up a company by name or ticker on Stock Analysis and returns its annual or quarterly income statement, balance sheet, or cash flow statement for the free periods.
stockanalysis.com/get_financial_statementsLists US IPOs from a chosen year, newest first. Each IPO comes with its IPO price, current price and return since IPO. Coverage begins in 2019.
stockanalysis.com/list_recent_iposGets an ETF's free holdings list from Stock Analysis by ticker or exact fund name: each holding's weight and shares, plus the fund's expense ratio, total number of holdings, holdings date and exact assets under management when shown.
stockanalysis.com/get_etf_holdingsGet a delayed US-listed stock snapshot from its ticker or company name. Analyst labels summarize Finviz's 1-5 mean score; dividend yield uses the estimated dividend when available. Missing metrics return null.
finviz.com/get_stock_snapshotLooks up a public company's size, financial figures and completed-year market-cap history from its name or ticker.
companiesmarketcap.com/get_company_sizeShows analyst recommendations, price targets, earnings estimates and recent rating changes for a public company on Yahoo Finance.
finance.yahoo.com/get_analyst_ratingsGets a stock's latest MSN Money quote and key facts by company name or ticker and listing country. Quotes may be delayed outside market hours.
msn.com/get_stock_quoteLooks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null.
sec.gov/get_company_financials