Default

Mutual Funds Holdings

Changed on

Get full Mutual Funds holdings/constituents. This endpoint covers both US and global mutual funds. For international funds, you must query the data using ISIN. A list of supported funds can be found <a href="/api/v1/mutual-fund/list?token=" target="_blank">here</a>.

get/mutual-fund/holdings

Request

  • Base URL
    https://finnhub.io/api/v1
  • URL
    https://finnhub.io/api/v1/mutual-fund/holdings
  • Auth
    API key in query parameter token

Query parameters

symbolstring

Fund's symbol.

isinstring

Fund's isin.

skipinteger

Skip the first n results. You can use this parameter to query historical constituents data. The latest result is returned if skip=0 or not set.

Response

successful operation

symbolstring

Symbol.

atDatestring date

Holdings update date.

numberOfHoldingsinteger

Number of holdings.

Example response

{
  "symbol": "symbol",
  "atDate": "2000-01-23",
  "holdings": [
    {
      "symbol": "symbol",
      "cusip": "cusip",
      "name": "name",
      "share": 6.0274563,
      "percent": 1.4658129,
      "value": 5.962134,
      "isin": "isin",
      "assetType": "assetType"
    },
    {
      "symbol": "symbol",
      "cusip": "cusip",
      "name": "name",
      "share": 6.0274563,
      "percent": 1.4658129,
      "value": 5.962134,
      "isin": "isin",
      "assetType": "assetType"
    }
  ],
  "numberOfHoldings": 0
}

Changes

  • fe3acff4e0d7Revision changes
    • info

      added the optional property // to the response with the status

  • 0f755a71e903Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status