Financial data API

Quick start

Resolve a company, then request the topic you need. Use a single metric to keep the response compact.

curl -X POST 'https://beanvest.com/api/v2/search' \
  -H 'Content-Type: application/json' \
  --data '{"query":"Tesla","limit":10}'

curl 'https://beanvest.com/api/v2/pages/tsla/valuation?metric=pfcf&range=5Y&limit=20'

Endpoints

POST/api/v2/search

Find names, tickers and share-class aliases. Paginated catalog and available pages.

GET/api/v2/pages/{symbol}/{topic}

The values, formulas, units, dates and sources behind a financial page.

GET/api/v2/metrics

Metric definitions and calculation conventions.

GET/api/v2/companies

Complete index with latest financial summaries and dated USD market caps.

GET/api/v2/financials/{symbol}

Validated raw data and full filing evidence. Use when you need the original inputs.

Every page, readable by an agent

Append .md or .json to any financial page or expanded chart URL. The response uses the same data and financial calculations as the charts.

https://beanvest.com/stock/tsla/revenue.md
https://beanvest.com/stock/meta/cash-flow.json?frequency=yearly
https://beanvest.com/stock/meta/valuation/charts/pe.json?range=ALL

The home equivalent is the public company catalog. Personal favorites stay in your browser.

Choose your data

Topics: overview, revenue, valuation, cash-flow, margins, returns and capital. Tesla also has deliveries and optimus.

frequency

quarterly or yearly. Valuation defaults to daily closes, with a fiscal-period fallback when daily history is unavailable.

range · from · to

Valuation: 1Y, 3Y, 5Y (default), 10Y or ALL. Optional inclusive ISO dates. Use ALL for date intervals older than five years.

metric

A single metric ID from the page definitions, such as pe, pfcf, fcf or roic.

deductSbc · wacc

Deduct SBC defaults to false. WACC accepts 0–100% and starts from the company industry proxy.

limit · offset

Newest first. Default 200 rows, maximum 1,000. Follow pagination.nextOffset. Company search allows up to 50 results per call.

Read the numbers correctly

• Money and shares use millions; EPS is currency per share. Percentages and percentage points are distinct units.
• Null means unavailable. Check row issues and pending filings. Coverage varies by company and metric.
• Fiscal dates and reporting currencies are retained. Annual EPS and weighted shares are not sums of quarterly figures.
• Valuation uses completed closes and published TTM financials. Median comparisons describe historical pricing; WACC is a scenario.
• Source URLs, retrieval dates and hashes travel with the data. Raw filing evidence is available through rawDataPath.

Invalid options return 400, unsupported companies/topics 404, and unavailable validated snapshots 503. The OpenAPI contract describes the response fields.