By field

How do I get the P/E ratio and valuation style of an equity fund by ISIN?

Portfolio price/earnings ratio and a derived value / blend / growth label for any equity fund or ETF from its ISIN as JSON: data.metrics.peRatio and data.profile.valuation.Updated 12 September 2026 · by FundFacts API

Short answer

Call GET https://fundfactsapi.com/api/v1/funds/{isin} with a bearer API key and read data.metrics.peRatio in the JSON response (related fields: data.profile.valuation). The P/E is read from the factsheet's portfolio characteristics (most index ETFs and many active funds print it). The Free plan gives 15 lookups a month with no card, and the keyless demo endpoint shows the shape for an already-loaded fund.

Where it is in the response

PathTypeMeaning
data.metrics.peRatiostringPortfolio P/E as printed.
data.profile.valuation"value" or "blend" or "growth" or nullFrom the P/E: <15 value, 15–22 blend, >22 growth.

Sample for iShares Core MSCI World UCITS ETF (IE00B4L5Y983):

json
"metrics": { "peRatio": "21.4" },
"profile": { "valuation": "blend" }

Where the figure comes from

The P/E is read from the factsheet's portfolio characteristics (most index ETFs and many active funds print it). The style label is derived with a fixed threshold so a screener can filter on it across fund houses.

The request

bash
curl -s --max-time 300 https://fundfactsapi.com/api/v1/funds/IE00B4L5Y983 \
-H "Authorization: Bearer $FUNDFACTS_API_KEY" | jq '.data.metrics.peRatio'
python
import os, requests
r = requests.get("https://fundfactsapi.com/api/v1/funds/IE00B4L5Y983",
headers={"Authorization": f"Bearer {os.environ['FUNDFACTS_API_KEY']}"}, timeout=300)
fund = r.json()
print(fund["name"], fund['data']['metrics']['peRatio'])
javascript
const res = await fetch("https://fundfactsapi.com/api/v1/funds/IE00B4L5Y983", {
headers: { Authorization: `Bearer ${process.env.FUNDFACTS_API_KEY}` },
signal: AbortSignal.timeout(300_000),
});
const fund = await res.json();
console.log(fund.name, fund.data.metrics.peRatio);

Sign up at fundfactsapi.com/signup for a key; the Free plan is 15 lookups a month with no card. Without a key, GET https://fundfactsapi.com/api/v1/demo/funds/IE00B4L5Y983 returns the same payload for funds already in the store (30 calls a minute per IP; it never loads a new fund).

Caveats

  • Trailing vs forward P/E depends on the fund house; the payload keeps the printed figure.
  • Empty for bond, money-market and most multi-asset funds.

Several funds at once

POST /funds with { "isins": ["…", "…"], "wait": true } returns the same payload for up to 10 ISINs per call on Starter, 50 on Pro and 200 on Scale. One request is counted per ISIN answered. X-RateLimit-Remaining on every response tells you how many are left this month; a 429 rate_limited response carries Retry-After. Search and /me are free.

A fund nobody has requested in the last 24 hours is loaded on demand from the documents the fund house publishes. That first call takes 15 seconds to about 3 minutes; set your client timeout to 300 seconds and do not fire a second request for the same ISIN while the first is running. Every later call within 24 hours returns from the store in well under a second with cached: true.

Everything else in the payload is listed in the field reference.

Verify it yourself

The demo endpoint returns the live payload for a fund that is already in the store, without a key. Everything on this page can be checked against it.
bash
curl -s https://fundfactsapi.com/api/v1/demo/funds/IE00B4L5Y983 | jq '{name, asOf: .data.dataAsOf, ter: .data.headlineMetrics.ter, risk: .data.riskRating, top: .data.topHoldings[:3]}'

Frequently asked questions

Do I need a credit card to try it?

No. The Free plan is 15 lookups per month with no card; sign up with an e-mail address or Google and the key is shown in the dashboard.

Which ISINs work?

Any share class of a UCITS fund, ETF, money-market fund or open-end fund whose management company publishes a product page, factsheet and KID. Each share class has its own ISIN and is looked up on its own. Stocks, bonds and indices are not funds and return 404 fund_not_found.

How current are the figures?

Each ISIN is re-read from the fund house's documents at most every 24 hours. data.dataAsOf is the as-of date printed on the documents, typically the last month end for a factsheet and the last trading day for holdings files.

Try it on your own ISINs

One request returns key facts, holdings, risk and performance as JSON. Free plan, no card.