FT APImarkets.ft.com ↗
Retrieve fund price, profile, top holdings, diversification, and investment objective from Financial Times Markets using ISIN and currency code.
What is the FT API?
The FT Markets Fund Tearsheet API returns 8 structured fields per fund — including current price, daily change, top holdings, asset diversification, and fund objective — from a single endpoint, get_fund_summary. Pass an ISIN and currency code to get a tearsheet covering fund profile metadata, manager details, charges, and portfolio weights in one response.
curl -X GET 'https://api.parse.bot/scraper/f5adb564-92dd-45c8-8c11-abcbcf6814d7/get_fund_summary?isin=LU0526609390¤cy=EUR' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace markets-ft-com-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: FT Markets Fund Tearsheet API — retrieve fund summary data."""
from parse_apis.markets_ft_com_api import FTFunds, FundNotFound
client = FTFunds()
# Fetch a fund's full tearsheet summary by ISIN and currency
fund = client.funds.get(isin="LU0526609390", currency="EUR")
print(f"{fund.fund_name} ({fund.symbol})")
print(f" ISIN: {fund.isin} Type: {fund.security_type}")
print(f" Price: {fund.price} {fund.price_currency} as of {fund.price_date}")
print(f" Today's change: {fund.todays_change} ({fund.todays_change_pct}%)")
print(f" 1-year change: {fund.one_year_change_pct}%")
# Exchange is null for mutual funds, present for ETFs
if fund.exchange is not None:
print(f" Exchange: {fund.exchange}")
# Inspect top holdings
for holding in fund.top_holdings:
print(f" Holding: {holding.company} — weight: {holding.portfolio_weight}")
# Check diversification breakdown
for alloc in fund.diversification.asset_type:
print(f" Asset: {alloc.name} — {alloc.percentage}")
# Typed error handling: catch a not-found fund
try:
client.funds.get(isin="XX0000000000", currency="ZZZ")
except FundNotFound as exc:
print(f"Fund not found: {exc.isin}:{exc.currency}")
print("exercised: funds.get / holdings / diversification / FundNotFound")
Retrieve a fund or ETF tearsheet summary from FT Markets by ISIN and share-class currency. Returns the fund name, current price, daily and annual price changes, a detailed profile (fund type, category, charges, domicile, managers, launch date), top holdings with portfolio weights, asset-type diversification breakdown, and the investment objective. Mutual funds resolve in one request. When the ISIN is an ETF (FT lists ETFs per stock-exchange listing rather than per share class), the ISIN is resolved through FT's security search and the listing quoted in the requested currency is loaded, preferring the exchange FT marks as the primary listing; this costs two extra requests, `security_type` is `etf`, `symbol` is the FT listing symbol (one shape: ticker:exchange:currency) and `exchange` names the listing venue. For mutual funds `security_type` is `fund` and `exchange` is null. An ISIN with no fund or ETF listing in the requested currency returns a stale_input (input_not_found) error. Numeric fields are numbers; holding weights and diversification percentages are strings as displayed (e.g. "8.87%"). Data is delayed at least 15 minutes.
| Param | Type | Description |
|---|---|---|
| isinrequired | string | ISIN (International Securities Identification Number) of the fund or ETF, e.g. LU0526609390 or LU0290356871. |
| currencyrequired | string | Currency code of the share class (funds) or of the exchange listing (ETFs), e.g. EUR, GBP, USD. |
{
"type": "object",
"fields": {
"isin": "string, the ISIN as requested",
"price": "number",
"symbol": "string, FT symbol actually loaded: ISIN:currency for funds, ticker:exchange:currency for ETFs",
"profile": "object containing fund profile key-value pairs (fund type, category, charges, domicile, etc.)",
"exchange": "string listing venue for ETFs (e.g. XETRA); null for funds",
"data_date": "string, FT's delay disclaimer containing the as-of date (ETFs include an intraday time)",
"fund_name": "string",
"objective": "string",
"price_date": "string, ISO date yyyy-MM-dd parsed from data_date",
"top_holdings": "array of top holdings with company name, one-year change, and portfolio weight",
"security_type": "string, 'fund' or 'etf'",
"todays_change": "number",
"price_currency": "string",
"diversification": "object with asset_type array (name and percentage pairs)",
"holdings_summary": "object with top_holdings_pct field",
"todays_change_pct": "number",
"one_year_change_pct": "number"
},
"sample": {
"data": {
"isin": "LU0290356871",
"price": 173.43,
"symbol": "DBXP:GER:EUR",
"profile": {
"ISIN": "LU0290356871",
"Domicile": "Luxembourg",
"Fund type": "SICAV",
"Launch date": "25 May 2007",
"Ongoing charge": "0.10%",
"Income treatment": "Accumulation",
"Available for sale": "Germany, Italy, United Kingdom",
"Morningstar category": "EUR Government Bond - Short Term"
},
"exchange": "XETRA",
"data_date": "Data delayed at least 15 minutes, as of Sep 16 2026 15:35 BST.",
"fund_name": "Xtrackers II Eurozone Government Bond 1-3 UCITS ETF 1C",
"objective": "The aim is for the investment to reflect the performance of the Markit iBoxx EUR Eurozone (DE ES FR IT NL) 1-3 Index.",
"price_date": "2026-09-16",
"top_holdings": [
{
"company": "France (Republic Of) 2.75%",
"one_year_change": "--",
"portfolio_weight": "8.87%"
},
{
"company": "Germany (Federal Republic Of) 1.3%",
"one_year_change": "--",
"portfolio_weight": "4.12%"
}
],
"security_type": "etf",
"todays_change": 0.11,
"price_currency": "EUR",
"diversification": {
"asset_type": [
{
"name": "Non-UK bond",
"percentage": "98.82%"
},
{
"name": "Cash",
"percentage": "1.18%"
}
],
"top_regions": []
},
"holdings_summary": {
"top_holdings_pct": 32.22
},
"todays_change_pct": 0.06,
"one_year_change_pct": 0.34
},
"status": "success"
}
}About the FT API
What the API Returns
The get_fund_summary endpoint accepts two required parameters: isin (the fund's International Securities Identification Number, e.g. LU0526609390) and currency (a three-letter code such as EUR, GBP, or USD). The response includes the fund_name, current price with price_currency, todays_change as a numeric value, and a data_date string indicating when the data was last recorded.
Fund Profile and Objective
The profile object contains key-value metadata for the fund: fund type, category, charges, domicile, named managers, and launch date. These fields map directly to what appears on an FT Markets fund tearsheet. The objective field returns the fund's stated investment objective as a text string — useful for screening or tagging funds by strategy without visiting individual pages.
Holdings and Diversification
The top_holdings array lists each major portfolio position with the company name, one-year price change, and portfolio weight as a percentage. The diversification object contains an asset_type array of name-and-percentage pairs showing how the fund allocates across asset classes (e.g. equities, bonds, cash). These two fields together give a structured snapshot of how the fund is positioned at the time of the request.
The FT API is a managed, monitored endpoint for markets.ft.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when markets.ft.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official markets.ft.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Screen funds by domicile and charge structure using fields from the
profileobject - Track daily price changes across a watchlist of funds by polling
get_fund_summarywith their ISINs - Extract fund investment objectives to build a strategy-tagged fund database
- Compare top holdings across multiple funds to identify overlap in portfolio positions
- Build an asset allocation dashboard using
diversification.asset_typepercentage breakdowns - Verify fund manager attribution by reading manager names from the
profileresponse - Monitor launch dates and fund metadata for regulatory or compliance tracking workflows
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Financial Times Markets have an official developer API?+
What does the `top_holdings` array include?+
top_holdings contains the holding's company name, its one-year price change, and its portfolio weight as a percentage of the fund. The number of entries reflects however many positions are shown on the FT Markets tearsheet for that fund.Does the API return historical price or performance time series data?+
Can I retrieve data for multiple share classes of the same fund in one call?+
get_fund_summary targets one ISIN and currency combination. Different share classes of the same fund each have their own ISIN, so you would need a separate request per share class. The API currently covers one fund tearsheet per call. You can fork it on Parse and revise it to support batch ISIN lookups.Are all funds available regardless of domicile or currency?+
currency parameter must match the fund's available share class currency — an unsupported currency for a given ISIN may yield no results.