Skip to main content
The Financial Datasets API serves annual fundamentals for 376 French-listed companies, active and delisted, including the CAC 40: income statements, balance sheets, cash flow statements, financial metrics, and as-reported statements. The data comes from the tagged annual reports French companies file. Amounts are in the currency the company reports in, EUR for most. Financial metrics carry no price-based values (market cap, valuation ratios) yet. See market coverage for every market. You can call it as a REST endpoint with an API key, or from Claude, ChatGPT, Cursor, and other AI apps through the MCP server, or pay per request with x402. Pricing starts at $20. French fundamentals use the same endpoints as US fundamentals. The only difference is how you name the company: a French ticker together with market=FR, or the company’s ISIN. This guide walks through both.

Prerequisites

  • Python 3.7+
  • A Financial Datasets API key (sign up here)
  • The requests library (pip install requests)

Step 1: Set Up Authentication

Step 2: Find a French Ticker

Every financials endpoint has a /tickers/ list. Filter it by market=FR to see the French companies we cover, each with its name, ISIN, and whether it is still listed.
French tickers are the short symbols the Paris market prints, so LVMH is MC and Air Liquide is AI.

Step 3: Fetch Income Statements

Add market=FR next to the ticker. French companies report once a year, so use period=annual.
Amounts are in the currency the company reports in. Read it from the currency field on each statement: most French companies report in EUR, some in USD (TotalEnergies, for one).

Step 4: Request by ISIN Instead

If you know the ISIN, pass it on its own. No ticker or market is needed.

Step 5: Fetch Balance Sheets and Cash Flow Statements

The Balance Sheets API and Cash Flow Statements API take the same parameters.
To get all three statements in one request, call the All Financial Statements API with the same parameters.

Step 6: Fetch Financial Metrics

The Financial Metrics API returns margins, growth, and per-share values for each annual period, and the Snapshot API the latest period.
Price-based values such as market cap, enterprise value, valuation ratios, and dividend yield are not available for French companies yet and come back as null.

Step 7: Fetch As-Reported Statements

As-reported statements give you the lines exactly as the company printed them in its annual report, with the company’s own labels and subtotals. Add /as-reported to any statement endpoint.

Annual Data Only

French companies file one tagged annual report a year, so period=annual is the only period. A request with period=quarterly or period=ttm returns a 400:

Next Steps

FAQ

Which French companies are covered?

Every French company that files a tagged annual report, active and delisted: 376 companies, including the CAC 40.

Which periods are available?

Annual only. period=quarterly and period=ttm return a 400.

Can I get the statements as the company printed them?

Yes. The as-reported endpoints return each line in the company’s own order and wording. See As-Reported Financial Statements.

Can an AI agent use this data?

Yes. Claude, ChatGPT, Cursor, and other MCP clients reach it through the Financial Datasets MCP server. An agent with a wallet can also pay per request with x402, with no account.