Time Series

Time Series API

Get Aggregated 12-Month Yield

The asset-weighted and rescaled aggregation of the 12 month yield of eligible holdings within a fund’s portfolio.

get

Query Parameters

idTypesstring

Comma-separated list specifying the type of each value passed in the ids parameter.

Rules:

  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value
  • Empty values default to performanceId

Example:

  • ids=id1,id2,id3
  • id1 and id3 are performance IDs
  • id2 is a security ID
  • idTypes=securityId,isin,cusip

Accepted values:

  • performanceId (default)
  • isin
  • securityId
  • cusip
  • tradingSymbol
  • msid

Example:securityId,isin,cusip

baseCurrencystring

Comma-separated list of 3-character ISO 4217 currency codes (for example, CAD, EUR, JPY).

  • Filters results based on currency
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Base currency passed for id2 and id4
  • baseCurrency=USD,USD,USD

Example:USD,USD,USD

domicilestring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).
Rules:

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Domicile passed for id2 and id4
  • domicile=,USA,,USA

Example:USA,USA,USA

exchangeCountrystring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange country passed for id2 and id4
  • exchangeCountry=,USA,,USA

Example:USA,USA,USA

exchangeIdstring

Comma-separated list of exchange IDs (for example, EX$$$$XMEX, EX$$$$XNAS).

  • Filters results based on exchange ID
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange ID passed for id2 and id4
  • exchangeId=,EX$$$$XMEX,,EX$$$$XNAS

Example:EX$$$$XMEX

frequencystring

Specifies the time interval between data points.

Allowed values:monthly

Default:monthly

startDatestring(date)

Specifies the start date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-01-01

endDatestring(date)

Specifies the end date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-05-01

timePeriodnumber

Specifies the size of the time window for the data range.

  • Used in combination with timePeriodUnit to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Example:12

timePeriodUnitstring

Specifies the time period unit.

  • Used in combination with timePeriod to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Allowed values:monthsdaysyears

applyEarliestCommonDateboolean

Specifies whether to apply the earliest common start date across all investments.

When set to true, the start date of the time series is adjusted to match the latest inception date among the investments, ensuring all data points are aligned.

Default:false

applyTrackRecordExtensionboolean

Specifies whether to apply the Track Record Extension logic in order to extend the performance of an investment by copying the historical performance of another qualified older investment.

Default:false

applyRestructureDateboolean

Specifies whether to consider the Morningstar or Custom restructure date when determining the start of the performance period.

This option is applicable only when applyEarliestCommonDate is set to true.

Default:false

sinceInceptionboolean

Sets the time range from inception (or the maximum supported lookback) to the end date.

Takes precendence over any timePeriod / timePeriodUnit and startDate / endDate settings.

Default:false

currencyIdstring

Specifies the currency in which to return data.

Allowed values:BASAUDBNDBRLCADCHFCLPCNHCNYCZKDKKEURGBPHKDHUFIDRILSINRJPYKRWMOPMXNMYRNOKNZDPLNRMBRUBSEKSGDTHBTWDUSDZAR

Default:BAS

Path Parameters

idsstringrequired

Comma-separated list of up to 25 investment identifiers to query.

Accepts:

  • Morningstar Performance ID (default)
  • Morningstar Security ID
  • Morningstar IDs (MSID)
  • ISIN
  • CUSIP
  • Trading symbol
  • Category ID
    Important: When a category ID is passed, the corresponding identifierType can be performanceId or securityId. The value must be URL-encoded. For example, if the category ID is LC00002226;CA]FO, the URL-encoded value is LC00002226;CA%5DFO.

Example:0P000000GY,US0378331005,037833100

Response

application/json

OK

ResponseTimeSeriesSingleObservation

List of investments for which time series data was returned.

* Additional properties are NOT allowed.
investmentsarray[object]

>= 1 items

* Additional properties are NOT allowed.
Show Child Parameters
metadataobject

Metadata returned in response. Includes information about identifiers for which no results were found.

* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/time-series/v1/performance/aggregated-12-month-yield/{ids}
 
application/json

Get Aggregated Sec Yield

The asset-weighted and rescaled aggregation of the SEC yield of eligible holdings within a fund’s portfolio.

get

Query Parameters

idTypesstring

Comma-separated list specifying the type of each value passed in the ids parameter.

Rules:

  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value
  • Empty values default to performanceId

Example:

  • ids=id1,id2,id3
  • id1 and id3 are performance IDs
  • id2 is a security ID
  • idTypes=securityId,isin,cusip

Accepted values:

  • performanceId (default)
  • isin
  • securityId
  • cusip
  • tradingSymbol
  • msid

Example:securityId,isin,cusip

baseCurrencystring

Comma-separated list of 3-character ISO 4217 currency codes (for example, CAD, EUR, JPY).

  • Filters results based on currency
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Base currency passed for id2 and id4
  • baseCurrency=USD,USD,USD

Example:USD,USD,USD

domicilestring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).
Rules:

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Domicile passed for id2 and id4
  • domicile=,USA,,USA

Example:USA,USA,USA

exchangeCountrystring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange country passed for id2 and id4
  • exchangeCountry=,USA,,USA

Example:USA,USA,USA

exchangeIdstring

Comma-separated list of exchange IDs (for example, EX$$$$XMEX, EX$$$$XNAS).

  • Filters results based on exchange ID
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange ID passed for id2 and id4
  • exchangeId=,EX$$$$XMEX,,EX$$$$XNAS

Example:EX$$$$XMEX

frequencystring

Specifies the time interval between data points.

Allowed values:monthly

Default:monthly

startDatestring(date)

Specifies the start date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-01-01

endDatestring(date)

Specifies the end date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-05-01

timePeriodnumber

Specifies the size of the time window for the data range.

  • Used in combination with timePeriodUnit to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Example:12

timePeriodUnitstring

Specifies the time period unit.

  • Used in combination with timePeriod to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Allowed values:monthsdaysyears

applyEarliestCommonDateboolean

Specifies whether to apply the earliest common start date across all investments.

When set to true, the start date of the time series is adjusted to match the latest inception date among the investments, ensuring all data points are aligned.

Default:false

applyTrackRecordExtensionboolean

Specifies whether to apply the Track Record Extension logic in order to extend the performance of an investment by copying the historical performance of another qualified older investment.

Default:false

applyRestructureDateboolean

Specifies whether to consider the Morningstar or Custom restructure date when determining the start of the performance period.

This option is applicable only when applyEarliestCommonDate is set to true.

Default:false

sinceInceptionboolean

Sets the time range from inception (or the maximum supported lookback) to the end date.

Takes precendence over any timePeriod / timePeriodUnit and startDate / endDate settings.

Default:false

currencyIdstring

Specifies the currency in which to return data.

Allowed values:BASAUDBNDBRLCADCHFCLPCNHCNYCZKDKKEURGBPHKDHUFIDRILSINRJPYKRWMOPMXNMYRNOKNZDPLNRMBRUBSEKSGDTHBTWDUSDZAR

Default:BAS

Path Parameters

idsstringrequired

Comma-separated list of up to 25 investment identifiers to query.

Accepts:

  • Morningstar Performance ID (default)
  • Morningstar Security ID
  • Morningstar IDs (MSID)
  • ISIN
  • CUSIP
  • Trading symbol
  • Category ID
    Important: When a category ID is passed, the corresponding identifierType can be performanceId or securityId. The value must be URL-encoded. For example, if the category ID is LC00002226;CA]FO, the URL-encoded value is LC00002226;CA%5DFO.

Example:0P000000GY,US0378331005,037833100

Response

application/json

OK

ResponseTimeSeriesSingleObservation

List of investments for which time series data was returned.

* Additional properties are NOT allowed.
investmentsarray[object]

>= 1 items

* Additional properties are NOT allowed.
Show Child Parameters
metadataobject

Metadata returned in response. Includes information about identifiers for which no results were found.

* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/time-series/v1/performance/aggregated-sec-yield/{ids}
 
application/json

Get Cumulative Return

get

Query Parameters

idTypesstring

Comma-separated list specifying the type of each value passed in the ids parameter.

Rules:

  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value
  • Empty values default to performanceId

Example:

  • ids=id1,id2,id3
  • id1 and id3 are performance IDs
  • id2 is a security ID
  • idTypes=securityId,isin,cusip

Accepted values:

  • performanceId (default)
  • isin
  • securityId
  • cusip
  • tradingSymbol
  • msid

Example:securityId,isin,cusip

baseCurrencystring

Comma-separated list of 3-character ISO 4217 currency codes (for example, CAD, EUR, JPY).

  • Filters results based on currency
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Base currency passed for id2 and id4
  • baseCurrency=USD,USD,USD

Example:USD,USD,USD

domicilestring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).
Rules:

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Domicile passed for id2 and id4
  • domicile=,USA,,USA

Example:USA,USA,USA

exchangeCountrystring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange country passed for id2 and id4
  • exchangeCountry=,USA,,USA

Example:USA,USA,USA

exchangeIdstring

Comma-separated list of exchange IDs (for example, EX$$$$XMEX, EX$$$$XNAS).

  • Filters results based on exchange ID
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange ID passed for id2 and id4
  • exchangeId=,EX$$$$XMEX,,EX$$$$XNAS

Example:EX$$$$XMEX

frequencystring

Specifies the time interval between data points.

Allowed values:daily

Default:daily

startDatestring(date)

Specifies the start date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-01-01

endDatestring(date)

Specifies the end date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-05-01

timePeriodnumber

Specifies the size of the time window for the data range.

  • Used in combination with timePeriodUnit to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Example:12

timePeriodUnitstring

Specifies the time period unit.

  • Used in combination with timePeriod to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Allowed values:monthsdaysyears

applyEarliestCommonDateboolean

Specifies whether to apply the earliest common start date across all investments.

When set to true, the start date of the time series is adjusted to match the latest inception date among the investments, ensuring all data points are aligned.

Default:false

applyTrackRecordExtensionboolean

Specifies whether to apply the Track Record Extension logic in order to extend the performance of an investment by copying the historical performance of another qualified older investment.

Default:false

applyRestructureDateboolean

Specifies whether to consider the Morningstar or Custom restructure date when determining the start of the performance period.

This option is applicable only when applyEarliestCommonDate is set to true.

Default:false

sinceInceptionboolean

Sets the time range from inception (or the maximum supported lookback) to the end date.

Takes precendence over any timePeriod / timePeriodUnit and startDate / endDate settings.

Default:false

currencyIdstring

Specifies the currency in which to return data.

Allowed values:BASAUDBNDBRLCADCHFCLPCNHCNYCZKDKKEURGBPHKDHUFIDRILSINRJPYKRWMOPMXNMYRNOKNZDPLNRMBRUBSEKSGDTHBTWDUSDZAR

Default:BAS

performanceTypestring

Specifies the type of performance calculation to apply. Accepts up to two values. The first value is considered the preferred or primary performance type. The second value is considered the secondary performance type and serves as a fallback if the preferred type returns no data. If only one value is provided, no fallback is attempted. Used with calculated data points only.

Allowed values:totalmarketgross

Default:total

Example:total

annualDaysnumber

Specifies the number of days in a year for annualized calculations. Common values are 252 for business days, 365 for calendar days. Used with calculated data points only.

Default:365.25

Example:365

annualizedboolean

Specifies whether the calculation results should be annualized. Used with calculated data points only.

Example:true

preCurrencystring

Specifies the currency to use before currency conversion. Accepts 3-character ISO 4217 currency codes. Used with calculated data points only.

Example:USD

requireContinueDataboolean

Specifies whether continuous data is required for calculations. Used with calculated data points only.

Example:true

stepSizenumber

Specifies the step size for rolling or iterative calculations. Used with ‘rolling-return’ data point only. For example, stepSize=12 and frequency=monthly 12-month rolling values are calculated.

Default:1

Example:12

Path Parameters

idsstringrequired

Comma-separated list of up to 25 investment identifiers to query.

Accepts:

  • Morningstar Performance ID (default)
  • Morningstar Security ID
  • Morningstar IDs (MSID)
  • ISIN
  • CUSIP
  • Trading symbol
  • Category ID
    Important: When a category ID is passed, the corresponding identifierType can be performanceId or securityId. The value must be URL-encoded. For example, if the category ID is LC00002226;CA]FO, the URL-encoded value is LC00002226;CA%5DFO.

Example:0P000000GY,US0378331005,037833100

Response

application/json

OK

ResponseTimeSeriesSingleObservation

List of investments for which time series data was returned.

* Additional properties are NOT allowed.
investmentsarray[object]

>= 1 items

* Additional properties are NOT allowed.
Show Child Parameters
metadataobject

Metadata returned in response. Includes information about identifiers for which no results were found.

* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/time-series/v1/performance/cumulative-return/{ids}
 
application/json

Get Current Yield

Annual income (interest or dividends) divided by the current price of the security. This measure looks at the current price of a bond instead of its face value and represents the return an investor would expect if he or she purchased the bond and held it for a year.

get

Query Parameters

idTypesstring

Comma-separated list specifying the type of each value passed in the ids parameter.

Rules:

  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value
  • Empty values default to performanceId

Example:

  • ids=id1,id2,id3
  • id1 and id3 are performance IDs
  • id2 is a security ID
  • idTypes=securityId,isin,cusip

Accepted values:

  • performanceId (default)
  • isin
  • securityId
  • cusip
  • tradingSymbol
  • msid

Example:securityId,isin,cusip

baseCurrencystring

Comma-separated list of 3-character ISO 4217 currency codes (for example, CAD, EUR, JPY).

  • Filters results based on currency
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Base currency passed for id2 and id4
  • baseCurrency=USD,USD,USD

Example:USD,USD,USD

domicilestring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).
Rules:

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Domicile passed for id2 and id4
  • domicile=,USA,,USA

Example:USA,USA,USA

exchangeCountrystring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange country passed for id2 and id4
  • exchangeCountry=,USA,,USA

Example:USA,USA,USA

exchangeIdstring

Comma-separated list of exchange IDs (for example, EX$$$$XMEX, EX$$$$XNAS).

  • Filters results based on exchange ID
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange ID passed for id2 and id4
  • exchangeId=,EX$$$$XMEX,,EX$$$$XNAS

Example:EX$$$$XMEX

frequencystring

Specifies the time interval between data points.

Allowed values:dailyweeklymonthlyquarterlyannually

Default:daily

startDatestring(date)

Specifies the start date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-01-01

endDatestring(date)

Specifies the end date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-05-01

timePeriodnumber

Specifies the size of the time window for the data range.

  • Used in combination with timePeriodUnit to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Example:12

timePeriodUnitstring

Specifies the time period unit.

  • Used in combination with timePeriod to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Allowed values:monthsdaysyears

applyEarliestCommonDateboolean

Specifies whether to apply the earliest common start date across all investments.

When set to true, the start date of the time series is adjusted to match the latest inception date among the investments, ensuring all data points are aligned.

Default:false

applyTrackRecordExtensionboolean

Specifies whether to apply the Track Record Extension logic in order to extend the performance of an investment by copying the historical performance of another qualified older investment.

Default:false

applyRestructureDateboolean

Specifies whether to consider the Morningstar or Custom restructure date when determining the start of the performance period.

This option is applicable only when applyEarliestCommonDate is set to true.

Default:false

sinceInceptionboolean

Sets the time range from inception (or the maximum supported lookback) to the end date.

Takes precendence over any timePeriod / timePeriodUnit and startDate / endDate settings.

Default:false

currencyIdstring

Specifies the currency in which to return data.

Allowed values:BASAUDBNDBRLCADCHFCLPCNHCNYCZKDKKEURGBPHKDHUFIDRILSINRJPYKRWMOPMXNMYRNOKNZDPLNRMBRUBSEKSGDTHBTWDUSDZAR

Default:BAS

Path Parameters

idsstringrequired

Comma-separated list of up to 25 investment identifiers to query.

Accepts:

  • Morningstar Performance ID (default)
  • Morningstar Security ID
  • Morningstar IDs (MSID)
  • ISIN
  • CUSIP
  • Trading symbol
  • Category ID
    Important: When a category ID is passed, the corresponding identifierType can be performanceId or securityId. The value must be URL-encoded. For example, if the category ID is LC00002226;CA]FO, the URL-encoded value is LC00002226;CA%5DFO.

Example:0P000000GY,US0378331005,037833100

Response

application/json

OK

ResponseTimeSeriesSingleObservation

List of investments for which time series data was returned.

* Additional properties are NOT allowed.
investmentsarray[object]

>= 1 items

* Additional properties are NOT allowed.
Show Child Parameters
metadataobject

Metadata returned in response. Includes information about identifiers for which no results were found.

* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/time-series/v1/performance/current-yield/{ids}
 
application/json

Get Daily Bid Price

The highest price a market maker will pay to purchase a specified number of shares of a mutual fund at any given time.

get

Query Parameters

idTypesstring

Comma-separated list specifying the type of each value passed in the ids parameter.

Rules:

  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value
  • Empty values default to performanceId

Example:

  • ids=id1,id2,id3
  • id1 and id3 are performance IDs
  • id2 is a security ID
  • idTypes=securityId,isin,cusip

Accepted values:

  • performanceId (default)
  • isin
  • securityId
  • cusip
  • tradingSymbol
  • msid

Example:securityId,isin,cusip

baseCurrencystring

Comma-separated list of 3-character ISO 4217 currency codes (for example, CAD, EUR, JPY).

  • Filters results based on currency
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Base currency passed for id2 and id4
  • baseCurrency=USD,USD,USD

Example:USD,USD,USD

domicilestring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).
Rules:

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Domicile passed for id2 and id4
  • domicile=,USA,,USA

Example:USA,USA,USA

exchangeCountrystring

Comma-separated list of 3-character ISO 3166‑1 country codes (for example, CAN, IRL, IND).

  • Filters results based on domicile
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange country passed for id2 and id4
  • exchangeCountry=,USA,,USA

Example:USA,USA,USA

exchangeIdstring

Comma-separated list of exchange IDs (for example, EX$$$$XMEX, EX$$$$XNAS).

  • Filters results based on exchange ID
  • Values must align with the order of values in ids
  • Use empty entries to skip
  • Omit trailing commas after the last non-empty value

Example:

  • ids=id1,id2,id3,id4,id5
  • Exchange ID passed for id2 and id4
  • exchangeId=,EX$$$$XMEX,,EX$$$$XNAS

Example:EX$$$$XMEX

frequencystring

Specifies the time interval between data points.

Allowed values:dailyweeklymonthlyquarterlyannually

Default:daily

startDatestring(date)

Specifies the start date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-01-01

endDatestring(date)

Specifies the end date for the time series. Accepted format is yyyy-MM-dd.

Example:2026-05-01

timePeriodnumber

Specifies the size of the time window for the data range.

  • Used in combination with timePeriodUnit to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Example:12

timePeriodUnitstring

Specifies the time period unit.

  • Used in combination with timePeriod to specify relative time ranges.

  • When startDate, endDate, timePeriod and timePeriodUnit are provided, timePeriod and timePeriodUnit take precedence.

Allowed values:monthsdaysyears

applyEarliestCommonDateboolean

Specifies whether to apply the earliest common start date across all investments.

When set to true, the start date of the time series is adjusted to match the latest inception date among the investments, ensuring all data points are aligned.

Default:false

applyTrackRecordExtensionboolean

Specifies whether to apply the Track Record Extension logic in order to extend the performance of an investment by copying the historical performance of another qualified older investment.

Default:false

applyRestructureDateboolean

Specifies whether to consider the Morningstar or Custom restructure date when determining the start of the performance period.

This option is applicable only when applyEarliestCommonDate is set to true.

Default:false

sinceInceptionboolean

Sets the time range from inception (or the maximum supported lookback) to the end date.

Takes precendence over any timePeriod / timePeriodUnit and startDate / endDate settings.

Default:false

currencyIdstring

Specifies the currency in which to return data.

Allowed values:BASAUDBNDBRLCADCHFCLPCNHCNYCZKDKKEURGBPHKDHUFIDRILSINRJPYKRWMOPMXNMYRNOKNZDPLNRMBRUBSEKSGDTHBTWDUSDZAR

Default:BAS

Path Parameters

idsstringrequired

Comma-separated list of up to 25 investment identifiers to query.

Accepts:

  • Morningstar Performance ID (default)
  • Morningstar Security ID
  • Morningstar IDs (MSID)
  • ISIN
  • CUSIP
  • Trading symbol
  • Category ID
    Important: When a category ID is passed, the corresponding identifierType can be performanceId or securityId. The value must be URL-encoded. For example, if the category ID is LC00002226;CA]FO, the URL-encoded value is LC00002226;CA%5DFO.

Example:0P000000GY,US0378331005,037833100

Response

application/json

OK

ResponseTimeSeriesSingleObservation

List of investments for which time series data was returned.

* Additional properties are NOT allowed.
investmentsarray[object]

>= 1 items

* Additional properties are NOT allowed.
Show Child Parameters
metadataobject

Metadata returned in response. Includes information about identifiers for which no results were found.

* Additional properties are NOT allowed.
Show Child Parameters
get/direct-web-services/time-series/v1/performance/daily-bid-price/{ids}
 
application/json