Get investment product fundamentals

GET

investment-products

{isin}

fundamentals

curl -X GET 'https://api.wealthyhood.com/investment-products/IE00B4L5Y983/fundamentals' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'x-user-id: 64f0c51e7fb3fc001234abcd'

{
  "fundamentals": {
    "topHoldings": [
      {
        "name": "Apple Inc.",
        "weight": "12.3%",
        "logoUrl": "https://cdn.wealthyhood.com/assets/aapl.svg"
      },
      {
        "name": "Microsoft Corp.",
        "weight": "9.8%",
        "logoUrl": "https://cdn.wealthyhood.com/assets/msft.svg"
      }
    ],
    "expenseRatio": "0.12",
    "indexStats": {
      "expectedReturn": "5.2%",
      "annualRisk": "12.4%",
      "dividendYield": "2.1%",
      "fpEarnings": "7.5%"
    },
    "holdingsCount": 98,
    "baseCurrency": "USD",
    "geographyDistribution": [
      {
        "name": "North America",
        "percentage": 68
      },
      {
        "name": "Europe",
        "percentage": 18
      }
    ],
    "sectorDistribution": [
      {
        "name": "Technology",
        "percentage": 42
      },
      {
        "name": "Consumer",
        "percentage": 16
      }
    ],
    "about": {
      "exchange": "LSE",
      "isin": "IE00B4L5Y983",
      "ticker": "VUSA.L",
      "assetClass": "Global Equities",
      "sector": "Broad Market",
      "advancedName": "Vanguard S&P 500 UCITS ETF",
      "description": "Tracks the performance of the S&P 500 index.",
      "provider": "Vanguard",
      "income": "ACCUMULATING",
      "replication": "Physical",
      "index": "S&P 500"
    },
    "news": [
      {
        "id": "12345",
        "title": "US stocks rally as earnings beat expectations",
        "text": "Major US equities moved higher after strong quarterly results.",
        "source": "Reuters",
        "newsUrl": "https://reuters.com/markets/us-stocks-rally",
        "imageUrl": "https://cdn.wealthyhood.com/news/us-rally.jpg",
        "date": "2024-07-11T09:20:00.000Z",
        "displayDate": "2h ago",
        "sentiment": "Positive",
        "type": "market"
      }
    ]
  },
  "currentPrice": 79.42,
  "tradedCurrency": "USD",
  "tags": [
    "FRACTIONAL",
    "MARKET_OPEN"
  ],
  "marketInfo": {
    "isOpen": true,
    "nextMarketOpen": 1720779600000
  },
  "kid": "https://cdn.wealthyhood.com/kid/VUSA.pdf"
}

{
  "status": 400,
  "error": {
    "message": "Unknown asset ISIN"
  },
  "responseId": "6d86bcab-9c21-45da-9b9d-820d598e1f3b"
}

{
  "status": 401,
  "error": {
    "message": "User not found"
  },
  "responseId": "145f2b0d-1d5b-4e91-8d0d-7af0ae9ad13a"
}

{
  "status": 403,
  "error": {
    "message": "Access forbidden for portfolio"
  },
  "responseId": "5e467f79-c62c-4d83-9810-7a0f8529fd76"
}

{
  "status": 404,
  "error": {
    "message": "Product not found"
  },
  "responseId": "0c8d8376-43db-4318-8ad4-0452bc0ce450"
}

Resolve an investment product by ISIN to retrieve pricing metadata, market tags, and the appropriate fundamentals payload for the asset type. ETF responses include holdings and index statistics, while stocks return analyst views and key metrics.

Authentication & headers

string

required

Bearer token issued by Auth0. Format: Bearer YOUR_ACCESS_TOKEN with the read:users scope.

string

required

MongoDB identifier of the requesting user (24-char hex). Required so locale- and subscription-aware fields can be applied.

Path parameters

string

required

ISIN of the investment product (12 alphanumeric characters).

curl -X GET 'https://api.wealthyhood.com/investment-products/IE00B4L5Y983/fundamentals' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'x-user-id: 64f0c51e7fb3fc001234abcd'

Response fields

The response structure varies based on asset type. ETFs return holdings, distributions, and fund metadata, while stocks return company information, financial metrics, and analyst ratings.

AssetFundamentals

required

Asset-type specific fundamentals. The structure varies by asset type:

Show ETF fundamentals (type: etf)

ETFHolding[]

Top holdings with name, weight percentage, and logo URL.

integer

Total number of holdings in the ETF.

string

Expense ratio formatted as percentage.

ETFIndexStats

Performance statistics including expected return, annual risk, and yield metrics.

ETFGeographyAllocation[]

Geographic allocation breakdown.

ETFSectorAllocation[]

Sector allocation breakdown.

ETFAbout

Fund information including provider, replication method, tracked index, and income type.

Show Stock fundamentals (type: stock)

StockAbout

Company information: ticker, exchange, sector, industry, description, employees, website, CEO, headquarters, and ISIN.

StockMetrics

Financial metrics: market cap, PE ratio, EPS, dividend yield, beta, and forward PE.

StockAnalystViews

Analyst ratings: average price target, percentage difference from current price, total analysts, and buy/sell/hold percentages.

number

required

Latest traded price in the asset’s traded currency.

"GBP" | "EUR" | "USD"

required

Primary settlement currency for the asset.

AssetTag[]

required

Commercial or trading flags that should be surfaced to end users.

MarketInfo

Current market status and the next opening timestamp.

uri

Link to the Key Information Document when the product requires one (primarily ETFs).

Authorizations

Authorization

string

header

required

Auth0-issued access token that includes the read:users scope.

Headers

x-user-id

string

required

MongoDB identifier of the Wealthyhood user whose subscription context should be applied.

Pattern: ^[a-f0-9]{24}$

Path Parameters

isin

string

required

ISIN of the investment product to retrieve.

Pattern: ^[A-Z0-9]{12}$

Response

Investment product fundamentals snapshot.

fundamentals

object

required

Fundamentals for an ETF.

Option 1
Option 2

Show child attributes

currentPrice

number<float>

required

Latest traded price in the main traded currency.

tradedCurrency

enum<string>

required

Available options:

GBP,

EUR,

USD

tags

enum<string>[]

required

Commercial and trading flags that should be surfaced to clients.

Available options:

FRACTIONAL,

ADR,

SMART_EXECUTION,

COMMISSION_FREE,

MARKET_OPEN,

MARKET_CLOSED

marketInfo

object

Show child attributes

kid

string<uri>

URL to the KID document when applicable.

Get price historyRetrieve historical price data for an investment product organized by tenor periods.

curl -X GET 'https://api.wealthyhood.com/investment-products/IE00B4L5Y983/fundamentals' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
  -H 'x-user-id: 64f0c51e7fb3fc001234abcd'

{
  "fundamentals": {
    "topHoldings": [
      {
        "name": "Apple Inc.",
        "weight": "12.3%",
        "logoUrl": "https://cdn.wealthyhood.com/assets/aapl.svg"
      },
      {
        "name": "Microsoft Corp.",
        "weight": "9.8%",
        "logoUrl": "https://cdn.wealthyhood.com/assets/msft.svg"
      }
    ],
    "expenseRatio": "0.12",
    "indexStats": {
      "expectedReturn": "5.2%",
      "annualRisk": "12.4%",
      "dividendYield": "2.1%",
      "fpEarnings": "7.5%"
    },
    "holdingsCount": 98,
    "baseCurrency": "USD",
    "geographyDistribution": [
      {
        "name": "North America",
        "percentage": 68
      },
      {
        "name": "Europe",
        "percentage": 18
      }
    ],
    "sectorDistribution": [
      {
        "name": "Technology",
        "percentage": 42
      },
      {
        "name": "Consumer",
        "percentage": 16
      }
    ],
    "about": {
      "exchange": "LSE",
      "isin": "IE00B4L5Y983",
      "ticker": "VUSA.L",
      "assetClass": "Global Equities",
      "sector": "Broad Market",
      "advancedName": "Vanguard S&P 500 UCITS ETF",
      "description": "Tracks the performance of the S&P 500 index.",
      "provider": "Vanguard",
      "income": "ACCUMULATING",
      "replication": "Physical",
      "index": "S&P 500"
    },
    "news": [
      {
        "id": "12345",
        "title": "US stocks rally as earnings beat expectations",
        "text": "Major US equities moved higher after strong quarterly results.",
        "source": "Reuters",
        "newsUrl": "https://reuters.com/markets/us-stocks-rally",
        "imageUrl": "https://cdn.wealthyhood.com/news/us-rally.jpg",
        "date": "2024-07-11T09:20:00.000Z",
        "displayDate": "2h ago",
        "sentiment": "Positive",
        "type": "market"
      }
    ]
  },
  "currentPrice": 79.42,
  "tradedCurrency": "USD",
  "tags": [
    "FRACTIONAL",
    "MARKET_OPEN"
  ],
  "marketInfo": {
    "isOpen": true,
    "nextMarketOpen": 1720779600000
  },
  "kid": "https://cdn.wealthyhood.com/kid/VUSA.pdf"
}

{
  "status": 400,
  "error": {
    "message": "Unknown asset ISIN"
  },
  "responseId": "6d86bcab-9c21-45da-9b9d-820d598e1f3b"
}

{
  "status": 401,
  "error": {
    "message": "User not found"
  },
  "responseId": "145f2b0d-1d5b-4e91-8d0d-7af0ae9ad13a"
}

{
  "status": 403,
  "error": {
    "message": "Access forbidden for portfolio"
  },
  "responseId": "5e467f79-c62c-4d83-9810-7a0f8529fd76"
}

{
  "status": 404,
  "error": {
    "message": "Product not found"
  },
  "responseId": "0c8d8376-43db-4318-8ad4-0452bc0ce450"
}

API documentation

Authentication

Automations

Universe Configuration

Users

Cash

Savings Vault

Bank Accounts

Account Closures

Deposits

Wallets

Withdrawals

Portfolios

Insights

Daily Summaries

Investment Products

Investment Orders

Savings Orders

Savings Details

Automations

Learn

Notification Settings

Transactions

Test

Get investment product fundamentals

Authentication & headers

Path parameters

Response fields

Authorizations

Headers

Path Parameters

Response

​Authentication & headers

​Path parameters

​Response fields

Authorizations

Headers

Path Parameters

Response

Authentication & headers

Path parameters

Response fields