Skip to main content
POST
Retrieve index and ETF constituent data.

Authorizations

Authorization
string
header
required

OAuth2 access-token requested from AWS Cognito and provided as a Auth Bearer header

Body

The query payload. Identifiers must be non-empty and each item needs a code and non-NotSet type; supply a date-only MarketDate, provider scope, and optional fallback and constituent-spot flags.

Queries index-component sets by index selector and market date.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.MarketData.ApiGetIndexComponentDataRequest, Derivitec.Web.Core
market_data_environment_name
string | null

Name of the market-data environment to use. Supply either this name or provider_id, not both.

Example:

"Example market data"

provider_id
string | null

Opaque identifier of the market-data provider to use. Supply either this identifier or market_data_environment_name, not both.

identifiers
object[] | null

Index or ETF selectors whose component sets are requested.

Instrument code qualified by an identifier namespace and optional market code.

market_date
string<date-time>

Market date of the requested component sets.

fallback_on_derivitec_data
boolean

Whether the lookup may fall back to the alternative Derivitec data source.

include_constituent_spot
boolean

Whether constituent spot observations are included.

Response

Returns available constituent rows with identifiers, weights, shares, divisors, optional spots, and errors for invalid identifiers, providers, dates, or missing components.

Returns index-component sets and query errors.

$type
enum<string>
required
Available options:
Derivitec.Web.Core.MarketData.ApiGetIndexComponentDataResponse, Derivitec.Web.Core
is_success
boolean

Whether the operation completed successfully. The default is true; error outcomes set it to false.

Example:

true

error_messages
string[] | null

Messages explaining operation-level failures. The collection is empty by default.

provider_id
string | null

Opaque identifier of the market-data provider associated with the returned data.

index_component_data
object[] | null

Index-component sets returned by the query.