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.FT_Markets_Fund_Tearsheet_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" Price: {fund.price} {fund.price_currency}")
print(f" Price date: {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}%")
# 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 / price_date / top_holdings / diversification / FundNotFound")
Retrieve a fund's tearsheet summary page from FT Markets. 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 fund's investment objective. Data is delayed at least 15 minutes.
| Param | Type | Description |
|---|---|---|
| isinrequired | string | ISIN (International Securities Identification Number) of the fund, e.g. LU0526609390 or GB00B3X7QG63. |
| currencyrequired | string | Currency code for the fund share class, e.g. EUR, GBP, USD. |
{
"type": "object",
"fields": {
"price": "number",
"symbol": "string",
"profile": "object containing fund profile key-value pairs (fund type, category, charges, domicile, etc.)",
"data_date": "string",
"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",
"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": {
"price": 65.59,
"symbol": "LU0526609390:EUR",
"profile": {
"ISIN": "LU0526609390",
"UK ISA": "--",
"Domicile": "Luxembourg",
"Fund size": "534.98m GBPAs of Jun 30 2026",
"Fund type": "SICAV",
"IMA sector": "--",
"Exit charge": "0.00%",
"Launch date": "06 Aug 2010",
"Initial charge": "--",
"Ongoing charge": "0.23%",
"Price currency": "GBP",
"Income treatment": "Income",
"Share class size": "2.09m GBPAs of Jun 30 2026",
"Max annual charge": "1.62%",
"Pricing frequency": "Daily",
"Available for sale": "Germany, Luxembourg, Switzerland",
"Manager & start date": "Jonathan Gregory21 Feb 2014Vivek Acharya09 Dec 2015",
"Morningstar category": "Global Diversified Bond - EUR Hedged",
"Min. initial investment": "--",
"Min. regular investment": "--",
"Investment style (stocks)": "Market Cap: SmallInvestment Style: Value",
"Min. additional investment": "--"
},
"data_date": "Data delayed at least 15 minutes, as of Jul 10 2026.",
"fund_name": "Focused SICAV - Global Bond (EUR hedged) F-UKdist",
"objective": "This actively managed sub-fund uses the benchmark Bloomberg Global Aggregate (hedged USD) as reference for portfolio construction, performance evaluation and risk management purposes.",
"top_holdings": [
{
"company": "United States Treasury Notes 4%",
"one_year_change": "--",
"portfolio_weight": "6.33%"
},
{
"company": "United Kingdom of Great Britain and Northern Ireland 4.375%",
"one_year_change": "--",
"portfolio_weight": "5.02%"
},
{
"company": "China Development Bank 3.45%",
"one_year_change": "--",
"portfolio_weight": "3.63%"
},
{
"company": "United States Treasury Notes 1.625%",
"one_year_change": "--",
"portfolio_weight": "2.21%"
},
{
"company": "Australia (Commonwealth of) 2.25%",
"one_year_change": "--",
"portfolio_weight": "2.01%"
}
],
"todays_change": 0.03,
"price_currency": "EUR",
"diversification": {
"asset_type": [
{
"name": "Non-UK bond",
"percentage": "84.05%"
},
{
"name": "UK bond",
"percentage": "8.83%"
},
{
"name": "Cash",
"percentage": "6.58%"
},
{
"name": "Non-UK stock",
"percentage": "0.00%"
},
{
"name": "UK stock",
"percentage": "0.00%"
},
{
"name": "Other",
"percentage": "0.54%"
}
],
"top_regions": []
},
"holdings_summary": {
"top_holdings_pct": 19.19
},
"todays_change_pct": 0.05,
"one_year_change_pct": -1.81
},
"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 | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. 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.