host: api.factset.com swagger: '2.0' consumes: - application/json produces: - application/json paths: /factset/etf/getBySymbol: get: tags: - Factset operationId: get/factset/etf/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- An ETP can be profiled by defining several common attributes such as issuer, fund description, and benchmark. summary: Factset Retrieve basic profile information for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Profile. type: object x-property-sort: - asOfDate - holdingsDate - symbol - exchange - name - issuer - brand - launchDate - description - website - domicile - status - currency - index - financialReport - createRedeem - aum - trading - documentation - insight properties: asOfDate: type: string format: date description: >- Date data was published. This data is available only for US region. holdingsDate: type: string format: date description: >- The as of data for holdings statistics. This data available only for US region symbol: type: string description: Ticker of the ETP. This data is available for all region. exchange: type: object x-property-sort: - code - name - country - region description: Exchange. properties: code: type: string description: >- Short Code of the exchange. This data is available for all the regions. name: type: string description: >- Name of the exchance where ETP is listed. This data is available for all the regions. country: type: string description: >- Short country code where ETP exchange is located. This data is available for all the regions and country code is in format ISO 3166-1 alpha-2. region: type: string description: >- Short region code where ETP exchange is located. This data is available for all the regions. x-enum-description: - Europe region. - North America region. - Asia-Pacific region. - Middle East & Africa. enum: - Europe - North America - Asia-Pacific - Middle East & Africa name: type: string description: >- Name of the ETP. This data is available for all the regions. issuer: type: object x-property-sort: - name description: Issuer. properties: name: type: string description: >- Name of the issuer of the ETP. This data is available for all the regions. brand: type: object x-property-sort: - name description: Brand. properties: name: type: string description: >- Name of the brand of the ETP. This data is available for all the regions. launchDate: type: string format: date description: >- Launch date of the ETP. This data is available for all the regions. description: type: string description: >- A brief description of the ETP. This data is available for all the regions. website: type: string description: >- Link to the ETP's homepage. This data is available for the US and Canada region. domicile: type: string description: >- ETP country of domicile. This data is available for all the regions and country code is in format ISO 3166-1 alpha-2. status: type: string description: >- Staus of the ETP. This data is available for all the regions. x-enum-description: - Active. - Delisted. - Not trading yet. enum: - Active - Delisted - Not trading yet currency: type: object x-property-sort: - listing - fund description: Currency. properties: listing: type: string description: >- Currency of exchange specific listing. This data is available for all the regions and currency code is in the format ISO 4217. fund: type: string description: >- Base calculation currency of the ETP. This data is available for all the regions and currency code is in the format ISO 4217. index: type: object x-property-sort: - name - family - website - distributionTreatment - rebalancingFrequency - currency description: The index the ETP is replicating, if applicable. properties: name: type: string description: >- The name of the underlying index of the ETP. This data is available for all the regions. family: type: string description: >- The name of the index provider for the underlying index of the ETP. This data is available for all the regions. website: type: string description: >- The link to the underlying index's homepage. This data is available for all the regions. distributionTreatment: type: string description: >- Describes the treatment of constituent cash flows by the index, whether capitalized (reinvested) or ignored, as well as tax withholding by foreign countries. Text and standardized value available for this data item. This data is available for Europe only. rebalancingFrequency: type: string description: >- Period of time between reweighting underlying index constituents. x-enum-description: - Monthly. - Annually. - Quarterly. - Semi-annual. - Daily. - As Needed. - Bi-Monthly. - Weekly. enum: - Monthly - Annually - Quarterly - Semi-annual - Daily - As Needed - Bi-Monthly - Weekly currency: type: string description: >- Base calculation currency of underlying index. This data is available for all the regions and currency code is in the format ISO 4217. financialReport: type: object x-property-sort: - annual - semiAnnual description: Financial report. properties: annual: type: object x-property-sort: - isAvailable - date description: Annual. properties: isAvailable: type: boolean description: >- States whether or not the current annual financial report is available on the issuer's website. This data is available for all the regions. date: type: string format: date description: >- Date of the last annual report available on issuer's site. This data is available for all the regions. semiAnnual: type: object x-property-sort: - isAvailable - date description: Semi annual. properties: isAvailable: type: boolean description: >- States whether or not the semi-annual financial report is available on the issuer's website. This data is available for all the regions. date: type: string format: date description: >- Date of the last semi-annual report available on the issuer's website. This data is available for all the regions. createRedeem: type: object x-property-sort: - unitCost - unitSize description: Create or redeem properties: unitCost: type: number format: real description: >- The standard fee in the ETP currency to create or redeem one unit of an ETP. This data is available for the US regions.. unitSize: type: number format: real description: >- The minimum ETP share block at which issuers are willing to perform creations or redemptions per prospectus or other filing documents. This data is available for the US regions. aum: type: number format: real description: >- The market value of the total assets that a individual ETP manages on behalf of it's investors. This data is available for all the regions. trading: type: object x-property-sort: - average - median description: Trading. properties: average: type: object x-property-sort: - volume - value description: Average. properties: volume: type: number format: real description: >- The average daily number of shares traded over the past 45 trading days. This data is available for the US regions. value: type: number format: real description: >- The average daily value traded over the past 45-trading day period in ETP's listing currency. This data is available for the US regions. median: type: object x-property-sort: - volume - value description: Median. properties: volume: type: number format: real description: >- Median daily number of shares traded over the past 45 trading days. This data is available for the regions. value: type: number format: real description: >- Median daily value traded over the past 45 trading days in ETP's listing currency. This data is available for the US regions. documentation: type: object x-property-sort: - isProspectusPosted - isSaiPosted description: Documentation. properties: isProspectusPosted: type: boolean description: >- Complete prospectus is available on issuer website. This data is available for all the regions. isSaiPosted: type: boolean description: >- Statement of Additional Information (SAI) is available on issuer website. This data is available for the US regions. insight: type: object x-property-sort: - overview - quote description: Insight. properties: overview: type: string description: >- In-depth ETP overview from FactSet ETP Analytics. This data is available for the US regions. quote: type: string description: >- Abbreviated ETP overview from the FactSet ETP Analytics. This data is available for the US regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/allocation/asset/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/asset/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by asset class. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's asset allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP asset allocation data. type: object x-property-sort: - reportDate - assets properties: reportDate: type: string format: date description: Reporting date for the allocations. assets: type: array items: type: object x-property-sort: - assetClass - weight properties: assetClass: type: string description: Name of the asset class. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by asset class(es). uniqueItems: true description: List of allocations by asset class. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/country/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/country/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by country names. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's country allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP country allocation data. type: object x-property-sort: - reportDate - countries properties: reportDate: type: string format: date description: Reporting date for the allocations. countries: type: array items: type: object x-property-sort: - country - weight properties: country: type: string description: Name of the country. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by country(s).. uniqueItems: true description: List of allocations by country. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/currency/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/currency/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by currency. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's currency allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP currency allocation data. type: object x-property-sort: - reportDate - currencies properties: reportDate: type: string format: date description: Reporting date for the allocations. currencies: type: array items: type: object x-property-sort: - currency - weight properties: currency: type: string description: Name of the currency. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by currency allocation(s). uniqueItems: true description: List of allocations by currency. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/economicDevelopment/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/economicDevelopment/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- List of allocations classified by a holding's economic development status (e.g. developed market, frontier market, emerging market). summary: >- Factset List of allocations classified by a holding's economic development status. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: List of allocations. type: object x-property-sort: - reportDate - classifications properties: reportDate: type: string format: date description: Reporting date for the allocations. classifications: type: array items: type: object x-property-sort: - name - weight properties: name: type: string description: >- Name of the classification. Possible values: "Developed Market", "Frontier Market", "Emerging Market", "Rest of World Market" weight: type: number format: percentage x-convertToRelative: false description: Weight (net) of the classification. description: >- List of allocations classified by a holding's economic development status, sorted by weight in descending order. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/exchange/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/exchange/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by exchanges. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's exchange allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP exchange allocation data. type: object x-property-sort: - reportDate - exchanges properties: reportDate: type: string format: date description: Reporting date for the allocations. exchanges: type: array items: type: object x-property-sort: - exchange - weight properties: exchange: type: string description: Name of the exchange. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by exchange(s). uniqueItems: true description: List of allocations by exchange. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/industry/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/industry/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by industry. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's industry allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP industry allocation data. type: object x-property-sort: - reportDate - industries properties: reportDate: type: string format: date description: Reporting date for the allocations. industries: type: array items: type: object x-property-sort: - industry - weight properties: industry: type: string description: Name of the industry. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by industry(s). uniqueItems: true description: List of allocations by industry. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/marketCapitalization/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/marketCapitalization/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- List of allocations classified by a holding's total market capitalization (e.g. Small Cap, Mid Cap, Large Cap). Response will be sorted by weight in descending order. summary: >- Factset List of allocations classified by a holding's total market capitalization. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: List of allocations. type: object x-property-sort: - reportDate - classifications properties: reportDate: type: string format: date description: Reporting date for the allocations. classifications: type: array items: type: object x-property-sort: - classification - weight properties: classification: type: string description: Name of the classification. weight: type: number format: real description: Weight (net) of the classification. uniqueItems: true description: >- List of allocations classified by a holding's total market capitalization (e.g. small caps, large caps). meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/region/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/region/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by region names. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's region allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP region allocation data. type: object x-property-sort: - reportDate - regions properties: reportDate: type: string format: date description: Reporting date for the allocations. regions: type: array items: type: object x-property-sort: - region - weight properties: region: type: string description: Name of the region. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by region(s).. uniqueItems: true description: List of allocations by region. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/allocation/sector/listBySymbol: get: tags: - Factset operationId: get/factset/etf/allocation/sector/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- This endpoint returns selected ETP's allocations grouped by sector names. The response will be sorted by weight in descending order. summary: Factset This endpoint returns selected ETP's sector allocations. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP sector allocation data. type: object x-property-sort: - reportDate - sectors properties: reportDate: type: string format: date description: Reporting date for the allocations. sectors: type: array items: type: object x-property-sort: - sector - weight properties: sector: type: string description: Name of the sector. weight: type: number format: real description: >- Consolidate weight of the position within the ETP by sector(s). uniqueItems: true description: List of allocations by sector. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/analytics/getBySymbol: get: tags: - Factset operationId: get/factset/etf/analytics/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- FactSet's proprietary analytical datapoints include ETP attributes specific to lending, corporate actions, and benchmarks. summary: FactSet proprietary analytics datapoints for ETPs. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Ticker-region of a security as defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Profile analytics. type: object x-property-sort: - asOfDate - securityLending - risk - benchmarkName - indexChange - medianBidAskSpread properties: asOfDate: type: string format: date description: >- Date the analytics data was published. Available for the regions: US, Europe, and Canada. securityLending: description: Security lending. type: object x-property-sort: - isAllowed - isActive - revenue - revenuePolicy properties: isAllowed: type: boolean description: >- Indicates whether a fund is permitted to lend securities based on their legal structure. Available for the regions: US, Europe, and Canada. isActive: type: boolean description: >- Indicates that revenue from lending securities was reported on the most recent annual or semi-annual report. Available for the regions: US, Europe, and Canada. revenue: type: number format: real description: >- The fraction of securities lending revenue that is rebated to the fund rather than kept by the issuer. Available for the regions: US, Europe, and Canada. revenuePolicy: type: string description: >- English description of the securities lending revenue policy, if any. Available for the regions: US, Europe, and Canada. risk: description: Risk. type: object x-property-sort: - isCorporateActionPending - counterParty - fundClosure properties: isCorporateActionPending: type: boolean description: >- Indicates a fund whose issuer has any corporate actions pending (e.g. merger, purchase, and closing). Available for the regions: US. counterParty: type: string description: >- Score predicting the likelihood that an ETN counterparty will default, as measured by 1-year credit default swap rates. Possible values are Low, Medium, or High. Empty for non-ETNs. Available for the regions: US. fundClosure: type: string description: >- Score estimating the likelihood that a fund will close. Based on a quantitative model. Outputs are Low, Medium, or High. Available for the regions: US. benchmarkName: type: string description: >- FactSet provides a neutral, broad market index that best represents an ETP segment, giving investors a measuring stick against which to compare a specific ETP. The fund's performance (for example, R2, beta, and standard deviation) and holdings are measured against it. Available for the regions: US and Europe. indexChange: type: object x-property-sort: - hasChanged - date description: Index change. properties: hasChanged: type: boolean description: >- States whether an index change has occurred. Available for the regions: US. date: type: string format: date description: >- Date of the most recent index change, if applicable. Available for the regions: US. medianBidAskSpread: type: number format: percentage x-convertToRelative: false description: >- The exchange-traded fund’s median bid-ask spread, expressed as a percentage rounded to the nearest hundredth, computed by: (A) Identifying the exchange-traded fund’s national best bid and national best offer as of the end of each 10 second interval during each trading day of the last 30 calendar days; (B) Dividing the ifference between each such bid and offer by the midpoint of the national best bid and national best offer; and (C) Identifying the median of those values. Available for the regions: US. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/analytics/holdings/statistics/getBySymbol: get: tags: - Factset operationId: get/factset/etf/analytics/holdings/statistics/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- FactSet calculates several proprietary portfolio statistics for ETPs including average maturity, credit quality, price/book ratio, price/earnings ratio, and dividend yield. summary: FactSet's portfolio statistics for ETPs. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Ticker-region of a security as defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Portfolio statistics. type: object x-property-sort: - asOfDate - numberHoldings - concentration - dividendYield - priceEarningsRatio - priceBookRatio - marketCapitalization - timeToMaturity - creditRating properties: asOfDate: type: string format: date description: >- Date the analytics data was published. Available for the regions: US, Europe, and Canada. numberHoldings: type: number format: int32 description: >- A measure of portfolio diversification, calculated by summing the squared weights of each fund constituent. Low concentration implies high diversification, and vice versa. Outputs are Low, Medium or High. Available for regions: US. concentration: type: string description: >- A measure of portfolio diversification, calculated by summing the squared weights of each fund constituent. Low concentration implies high diversification, and vice versa. Possible values are Low, Medium or High. Available for regions: US. dividendYield: type: number format: percentage x-convertToRelative: false description: >- The annualized weighted average of the current dividend yield of the portfolio's holdings, gross of fees. Available for the regions: US. priceEarningsRatio: type: number format: real description: >- Weighted average ratio of prices of a fund’s stocks values to their trailing earnings of underlying stocks. Aggregate prices are scaled by the sum of individual earnings, including negative earnings. Available for the regions: US. priceBookRatio: type: number format: real description: >- Weighted average ratio of prices of a fund’s stocks to the book value of underlying stocks. Aggregate prices are scaled by the sum of individual book values. Available for the regions: US. marketCapitalization: type: number format: real description: >- The weighted average market capitalization of the stocks in the fund's portfolio (USD). Available for regions: US. timeToMaturity: type: number format: real description: >- The weighted average of remaining time until maturity for all bonds in the portfolio, measured in (possibly fractional) years. Available for the regions: US. creditRating: type: string description: >- Average credit rating for the portfolio, determined by mapping ratings from credit agencies (Fitch, Moody's and Standard & Poor's) to numerical likelihood of default for each bond in the portfolio and then finding the weighted average default probability, then mapping back to an agency credit rating. Accounts for the nonlinear probability of default when aggregating agency ratings. FactSet has developed a numeric equivalent system that allows math functions such as averaging and comparisons across sources (using greater than, equal to, or less than operators), to facilitate easier evaluation. Available for the regions: US. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/analytics/score/getBySymbol: get: tags: - Factset operationId: get/factset/etf/analytics/score/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- FactSet calculates various proprietary fund rankings including unique scores, fund grades, segment averages, and recommendations. summary: FactSet proprietary ETP rankings. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Ticker-region of a security as defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Score analytics. type: object x-property-sort: - efficiency - tradability - fit - grade - analystPick - onOpportunitiesList - fitRsquared - beta - standardDeviationDown properties: efficiency: type: object x-property-sort: - value - average description: Efficiency. properties: value: type: number format: real description: >- A measure of how well a fund delivers on its core promise of delivering the returns of an underlying index, taking into account the expense ratio, tracking error, tax risk, fund closure risk and structural risk. In the range 0 (low) to 100 (high). Available for the regions: US. average: type: number format: real description: >- The average efficiency score for all funds in the segment. Available for the regions: US. tradability: type: object x-property-sort: - value - average description: Tradability. properties: value: type: number format: real description: >- A total view of the liquidity of a fund taking into account share-level liquidity as well as the underlying liquidity of a fund's portfolio of securities. In the range 0 (low) to 100 (high). Available for the regions: US. average: type: number format: real description: >- The average tradability score for all funds in the segment. Available for the regions: US. fit: type: object x-property-sort: - value - average description: Fit. properties: value: type: number format: real description: >- A measure of the exposure a fund provides relative to its FactSet designated 'Segment Benchmark'. Scored in the range 0 (low) to 100 (high), with higher scores indicating better alignment with the performance and holdings of the Segment Benchmark. Available for the regions: US. average: type: number format: real description: >- The average Fit score for all funds in the segment. Available for the regions: US. grade: type: string description: >- Combining the efficiency and tradability scores, FactSet assigns a letter grade (A-F) that provides a concise view on how efficient and tradable each ETP is. Available for the regions: US. analystPick: type: boolean description: >- If true, this fund has been chosen by the FactSet ETP Analytics Team to provide comprehensive, market-like exposure to an area of the market/segment, keeping costs and liquidity in mind. Available for the regions: US. onOpportunitiesList: type: boolean description: >- If true, this fund has been chosen by the FactSet ETP Analytics Team as providing potentially valuable but alternative exposure to the market/segment, keeping costs and liquidity in mind. Available for the regions: US. fitRsquared: type: number format: real description: >- The degree to which the daily returns of fund NAV and its FactSet designated segment benchmark move up and down in unison, ranging from 1.0 (perfect co-movement) to zero (no relation). Available for the regions: US. beta: type: object x-property-sort: - value - up - down description: Beta. properties: value: type: number format: real description: >- The sensitivity of the returns of the fund to the movement of the FactSet designated 'segment benchmark'. Beta of 1.0 means magnitude of fund returns equals that of segment benchmark returns. Available for the regions: US. up: type: number format: real description: >- A comparison of a fund's return to the FactSet-designated benchmark's for days when the benchmark is up. Ideally down beta is less than or equal to overall beta. Available for the regions: US. down: type: number format: real description: >- A comparison of a fund's return to the FactSet-designated benchmark's for days when the benchmark is down. Ideally down beta is less than or equal to overall beta. Available for the regions: US. standardDeviationDown: type: number format: real description: >- A measure of the variability between the fund's returns and the FactSet designated segment benchmark returns on days when the fund underperforms the benchmark. Available for the regions: US. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/analytics/trade/getBySymbol: get: tags: - Factset operationId: get/factset/etf/analytics/trade/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Various metrics of an ETP's liquidity including creation metrics, premium/discount, spread, and tracking error statistics. summary: Factset Trade statistics for specific ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Ticker-region of a security as defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Trade analytics. type: object x-property-sort: - impedimentsToCreation - premiumDiscount - blockTrade - spread - trackingDifference properties: impedimentsToCreation: type: object x-property-sort: - value - reason description: Impediments to creation. properties: value: type: string description: >- Indicates whether a fund is fully or partially closed to creations, or is likely to become fully or partially closed to creations. Values are None, Potential, Partial, Full. Available for the regions: US. reason: type: string description: >- States the reason why there is an impediment to creations. Available for the regions: US. premiumDiscount: type: object x-property-sort: - median - max description: >- The difference between the last share price of the ETF and its end-of-day net asset value (NAV). A positive difference is called premium and a negative difference is called discount. properties: median: type: number format: real description: >- The median premium or discount over the last 12 months. Available for the regions: US. max: type: number format: real description: >- The greatest absolute amount that the market price exceeded (premium) and lagged (discount) its net asset value (NAV) over a 12-month period. Available for the regions: US. blockTrade: description: Properties of the ETP with respect to large trades. type: object x-property-sort: - overlapHours - underlyingVolumePerUnit - liquidity - creationUnitPerDay properties: overlapHours: type: number format: real description: >- A measurement of the overlap between the hours of trading for the ETF and that of its underlying portfolio. Available for the regions: US. underlyingVolumePerUnit: type: number format: percentage x-convertToRelative: false description: >- Weighted average of the ratios of each underlying's number of shares, represented in one creation unit of the ETP, relative to the median daily trading volume of the underlying over 45 trading days, expressed as a percentage. This is a measure of the liquidity available in the underlying portfolio of the ETP, whereby larger numbers indicate greater likelihood of adverse price impact on underlying securities from ETF creations/redemptions. Only applicable for ETF. Available for the regions: US. liquidity: type: number format: int32 description: >- A measurement of the liquidity available in an ETF for a hypothetical 1,000,000 USD trade. Measured on a scale of 0 to 5 -- 5 being very liquid and easy to execute, 1 being expensive and difficult to execute, and 0 indicating a closed or restricted creation window. Available for the regions: US. creationUnitPerDay: type: number format: real description: >- The median 45 day share volume divided by the creation unit size of the fund. The higher the number, the more likely that liquidity providers will trade the fund in size, or in odd lots. Available for the regions: US. spread: description: >- The 45-day median of daily time-weighted dollar or percentage difference between the highest posted price a market participant is willing to pay to buy an ETF and the lowest posted price at which a market participant is willing to sell an ETF. type: object x-property-sort: - absolute - relative properties: absolute: type: number format: real description: >- Dollar spread difference. Available for the regions: US. relative: type: number format: percentage x-convertToRelative: false description: >- Percentage spread difference. Available for the regions: US. trackingDifference: type: object x-property-sort: - median - maxUpside - maxDownside description: Tracking difference. properties: median: type: number format: percentage x-convertToRelative: false description: >- The median difference between NAV and fund index returns over a one-year set of rolling 12 month holding periods. This statistic captures all inputs to tracking difference: expense ratio, optimization, securities lending income, and tax recapture. Available for the regions: US. maxUpside: type: number format: percentage x-convertToRelative: false description: >- Greatest, or least negative 12-month difference between NAV and index returns over a rolling 12 month period. Available for the regions: US. maxDownside: type: number format: percentage x-convertToRelative: false description: >- Most negative or least positive 12-month difference between NAV and index returns over a rolling 12 month period. Available for the regions: US. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/characteristics/getBySymbol: get: tags: - Factset operationId: get/factset/etf/characteristics/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- An ETP has many unique characteristics specific to its composition that differentiate it from other products. This includes details on leverage, hedging, derivatives, and service providers. summary: Factset Retrieve basic characteristic information for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETF defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Characteristics. type: object x-property-sort: - gearing - hedge - counterParty - serviceProvider properties: gearing: description: Gearing. type: object x-property-sort: - isInverseFund - leverage - exposureResetPeriod properties: isInverseFund: type: boolean description: >- Flags ETPs that deliver short exposure to an index, including leveraged short exposure. This data is available for all the regions. leverage: description: Leverage. type: object x-property-sort: - isLeverageFund - factor - type properties: isLeverageFund: type: boolean description: >- Flags ETPs that deliver leveraged long exposure to an index. This data is available for all the regions. factor: type: number format: real description: >- Leverage factor of leveraged and inverse ETPs (2x, 3x, 1.5x, -1.5x, -2x, -3x, variable). This data is available for all the regions. type: type: string description: >- Determines if leverage factor is fixed or variable. This data is available for all the regions. exposureResetPeriod: type: string description: >- Exposure reset frequency of leveraged and inverse ETPs, text and standardized value available. This data is available for all the regions. x-enum-description: - Daily. - Variable. - None. - Monthly. - Quarterly. enum: - Daily - Variable - None - Monthly - Quarterly hedge: description: Hedge. type: object x-property-sort: - isHedged - sourceCurrency - targetCurrency properties: isHedged: type: boolean description: >- Flags ETPs that are hedged to eliminate or reduce foreign currency exposure for US investors. This data is available for all the regions. sourceCurrency: type: string description: >- For currency-hedged funds, the values shows foreign currency the ETP is hedged against. Currency code is in ISO 4217 format. This data is available for all the regions. targetCurrency: type: string description: >- For currency-hedged funds, the currency the ETP is exposed to after hedging. Currency code is in ISO 4217 format. This data is available for all the regions. counterParty: description: Counter Party. type: object x-property-sort: - credit - swap - holdsDerivatives properties: credit: type: string description: >- Name of the ETP's credit counterparty. This data is available for all the regions. swap: type: string description: >- Name of the ETP's swap counterparty. This data is available for all the regions. holdsDerivatives: type: boolean description: >- Flags ETPs that are expected to hold OTC derivatives in the course of normal fund operations. This data is available for the US and Canada regions. serviceProvider: description: Service Provider. type: object x-property-sort: - primaryAdvisor - subAdvisor - distributor - isIssuerAffiliate properties: primaryAdvisor: type: string description: >- The name of the primary advisor of the ETP. This data is available for the US and Canada regions. subAdvisor: type: string description: >- The name of the sub-advisor of the ETP. This data is available for the US and Canada regions. distributor: type: string description: >- The name of the distributor of the ETP. This data is available for the US region. isIssuerAffiliate: type: boolean description: >- Describes whether the swap counterparty is affiliated with the issuer. This data is available for the Europe regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/class/getBySymbol: get: tags: - Factset operationId: get/factset/etf/class/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- ETP classification is divided into three categories: Asset Class, Geography, and Investment Strategy. Asset class is determined based on the various asset types held by the fund, A fund's geography can be classified by region (e.g. Asia-Pac), specific geography (e.g. China) or economic development (e.g. BRIC). An ETP's investment strategy is classified in broad categories (e.g. Large Cap) and more granular categorizations. summary: >- Factset Retrieve an ETP's classification specific to asset class, geography, or investment strategy. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Class information of given ETP. type: object x-property-sort: - asset - economicDevelopment - geography - category properties: asset: type: string description: >- Asset class of ETP holdings (Equity, Fixed Income, Currency, Commodities, Asset Allocation, or Alternatives), text and standardized value available. This data is available for all the regions. x-enum-description: - Equity. - Alternatives. - Fixed Income. - Commodities. - Currency. - Asset Allocation. enum: - Equity - Alternatives - Fixed Income - Commodities - Currency - Asset Allocation economicDevelopment: type: string description: >- The country development level of the ETP's holdings (Developed, Emerging, Frontier, or Blended), text and standardized value available. This data is available for all the regions. x-enum-description: - Developed Markets. - Blended Development. - Emerging Markets. - Frontier Markets. enum: - Developed Markets - Blended Development - Emerging Markets - Frontier Markets geography: description: geography. type: object x-property-sort: - region - specific properties: region: type: string description: >- The broad regional exposure of the ETP's holdings (e.g., Latin America, Asia-Pacific, Global), text and standardized value available. This data is available for all the regions. x-enum-description: - Europe. - North America. - Global. - Developed Markets. - Asia-Pacific. - Global Ex-U.S. - Emerging Markets. - Latin America. - Middle East & Africa. - Frontier Markets. enum: - Europe - North America - Global - Developed Markets - Asia-Pacific - Global Ex-U.S. - Emerging Markets - Latin America - Middle East & Africa - Frontier Markets specific: type: string description: >- The specific geographic exposure of the ETP's holdings (e.g., BRICs, Chile, Asia-Pacific Ex-Japan), text and standardized value available. This data is available for all the regions. See endpoint /factset/etf/class/geography/list for possible values category: description: category. type: object x-property-sort: - broad - focus - niche properties: broad: type: string description: >- The 1st of 3 asset-class-specific, hierarchical exposure tiers; the broadest category the ETP falls under within its asset class (e.g., Size & Style, Sector, Precious Metals, Absolute Returns), text and standardized value available. This data is available for all the regions. Please refer /factset/etf/class/category/broad/list for possible values. focus: type: string description: >- The 2nd of 3 asset-class-specific, hierarchical exposure tiers; the ETP's classification within its category (e.g., Small Cap, Energy, Palladium, Long/Short), text and standardized value available. This data is available for all the regions. Please refer /factset/etf/class/category/focus/list for possible values. niche: type: string description: >- The 3rd of 3 asset-class-specific, hierarchical exposure tiers; The ETP's classification within its Focus. Most granular tier of exposure sort (e.g., Growth, Coal, Physically held, Merger Arbitrage), text and standardized value available. This data is available for all the regions. Please refer /factset/etf/class/category/niche/list for possible values. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/class/category/broad/list: get: tags: - Factset operationId: get/factset/etf/class/category/broad/list x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: List of ETP class broad categories. summary: Factset List of ETP class broad categories. responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - broadCategory properties: broadCategory: type: string description: ETP class broad category. uniqueItems: true description: List of ETP class broad categories. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status parameters: - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. /factset/etf/class/category/focus/list: get: tags: - Factset operationId: get/factset/etf/class/category/focus/list x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: List of ETP class focus categories. summary: Factset List of ETP class focus categories. responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - focusCategory properties: focusCategory: type: string description: ETP class focus category. uniqueItems: true description: List of focus categories. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination parameters: - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query /factset/etf/class/category/niche/list: get: tags: - Factset operationId: get/factset/etf/class/category/niche/list x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: List of ETP class niche categories. summary: Factset List of ETP class niche categories. responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - nicheCategory properties: nicheCategory: type: string description: ETP class niche category. uniqueItems: true description: List of niche categories. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination parameters: - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query /factset/etf/class/geography/list: get: tags: - Factset operationId: get/factset/etf/class/geography/list x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: List of ETP class geographies. summary: Factset List of ETP class geographies. responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - name properties: name: type: string description: Name of the geography. uniqueItems: true description: List of class geographies. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status parameters: - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. /factset/etf/competitors/listBySymbol: get: tags: - Factset operationId: get/factset/etf/competitors/listBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- FactSet defines and maintains a proprietary list of competing companies based on a number of attributes specific to a fund. summary: FactSet's proprietary list of competing companies. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Ticker-region of a security as defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - symbol - name properties: symbol: type: string description: Ticker-region as defined by FactSet. name: type: string description: Name of the competitor. uniqueItems: true description: Competitor's data. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/distribution/getBySymbol: get: tags: - Factset operationId: get/factset/etf/distribution/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve distribution-related details for a specific ETP including dividend and capital gain distribution details. summary: Factset Retrieve an ETP's current distribution details. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Distribution. type: object x-property-sort: - dividend - capitalGains - totalDistribution - distributionYield properties: dividend: description: Dividend information for the next dividend. type: object x-property-sort: - isReported - exDividendDate - qualified - nonQualified - returnOfCapital properties: isReported: type: boolean description: >- States whether the ETP's next ex-dividend date is posted on the issuer's website. This data is available for all the regions. exDividendDate: type: string format: date description: >- The ex-dividend date of the ETP's next distribution. This data is available for all the regions. qualified: type: number format: real description: >- Qualified dividend payment on ex-dividend-date indicates the amount of distribution considered to have a more favorable tax treatment. This data is available for all regions. nonQualified: type: number format: real description: >- Non-Qualified dividend payment on ex-dividend-date indicates the amount of distribution that is taxed as ordinary income. This data is available for all regions. returnOfCapital: type: number format: real description: >- Return of Capital available on ex-dividend-date. This data is available for all regions. capitalGains: description: Capital Gains. type: object x-property-sort: - shortTerm - longTerm properties: shortTerm: type: number format: real description: >- Total short term capital gains on ex-date indicates the amount of the distribution that is subject to short term tax rates.This data is available for all the regions. longTerm: type: number format: real description: >- Total long term capital gains on ex-date indicates the amount of the distribution that is subject to long term tax rates. This data is available for all the regions. totalDistribution: type: number format: real description: >- Total Distribution on exDividend-date. Values are in the ETP's listing currency in the ISO 4217 format. This data is available for all regions. Please refer currency.listing in /factset/etf/getBySymbol for currency value. distributionYield: type: number format: real description: >- Total 12-month distribution of the ETP multiplied by split factor then divided by its net asset value. Data is split adjusted. This data is available for the US regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/fundFlows/getBySymbol: get: tags: - Factset operationId: get/factset/etf/fundFlows/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve the amount invested or divested in a specific ETP over various time periods including one-day, one-week, one-month, one-year, and YTD. summary: Factset Retrieve an ETP's cash inflow/outflows for various time periods. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: >- Fund flows (i.e., the amount invested or divested from a fund) based on the creation/redemption process. The data returned may not be related to overall volume or price movement. All fund flow inputs use transaction-day values to ensure that all assets under management (AUM) and flows are fully comparable and reflective of the same, verified market conditions. This data is available for all the regions. type: object x-property-sort: - flows1D - flows1W - flows1M - flowsYTD - flows1Y properties: flows1D: type: number format: real description: >- One-day fund flows. This data is available for all the regions. flows1W: type: number format: real description: >- One-week fund flows. This data is available for all the regions. flows1M: type: number format: real description: >- One-month fund flows. This data is available for all the regions. flowsYTD: type: number format: real description: >- Year-to-date fund flows. This data is available for all the regions. flows1Y: type: number format: real description: >- One-year fund flows. This data is available for all the regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/growthOfTenK/listBySymbol: get: tags: - Factset operationId: get/factset/etf/growthOfTenK/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Growth of 10K (or growth of 10,000) is a commonly used chart that highlights the change in the value of an initial 10,000 investment in the ETP during a given period of time. Often, this period of time is either since inception or the calculation between the pre-defined range. summary: Factset This endpoint returns selected ETP's Growth of 10K calculated values. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: timePeriod in: query type: string required: false description: Historice NAV date value. x-enum-description: - One month. - Three months. - Six months. - Year to date. - One year. - Three year. - Five years. - Ten years. - Since Inception. enum: - 1M - 3M - 6M - YTD - 1Y - 3Y - 5Y - 10Y - SI - name: calculationType in: query type: string required: false description: Historice NAV date value. x-enum-description: - >- Interval - Growth of 10000 calculated based on pre-defined time Period. - >- Since Inception - Growth of 10000 calculation starts from the inception. enum: - I - SI - name: alignment in: query type: string required: false description: Indicates the reference point for growth of 10k data. x-enum-description: - >- Growth of 10k data is shown relative to the most recent (usually daily) end-of-day 10k value, NAV change percent. - >- Growth of 10k data is shown relative to the 10k value, NAV change percent at the most recent end-of-week. - >- Growth of 10k data is shown relative to the 10k value, NAV change percent at the most recent end-of-month. enum: - day - week-end - month-end - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - navDate - tenkValue - tenkPercentChange properties: navDate: type: string format: date description: Growth of the 10k calculation date tenkValue: type: number format: real description: Growth of the 10k calculation value. tenkPercentChange: type: number format: real description: Growth of the 10k calculation percent change. uniqueItems: true description: Growth of TenK data. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/holdings/listBySymbol: get: tags: - Factset operationId: get/factset/etf/holdings/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve an ETP's holdings information including security, shares held, and weight. summary: Factset Holdings details for an individual ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - symbol - name - securityType - exchange - reportDate - shares - marketValue - currencyCode - weight properties: symbol: type: string description: Identifier of the holding. (when available). name: type: string description: Name of the holding. securityType: type: string description: Financial instrument type of the holding. exchange: type: object x-property-sort: - code - name description: Exchange. properties: code: type: string description: >- Short Code of the exchange where holding is listed. This data is available for all the regions. name: type: string description: >- Name of the exchange where holding is listed. This data is available for all the regions. reportDate: type: string format: date description: Reporting date of the holding. shares: type: number format: real description: Number of shares held, unadjusted for corporate actions. marketValue: type: number format: real description: >- Market value of the holding, unadjusted for corporate actions. currencyCode: type: string description: >- Code representing the currency of the holding and it's in format ISO 4217 weight: type: number format: real description: Weight of the holding within the ETP. uniqueItems: true description: ETP holdings data. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/marketAggregates/getBySymbol: get: tags: - Factset operationId: get/factset/etf/marketAggregates/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Market Aggregates combines FactSet Estimates, FactSet Fundamentals, and FactSet Prices data to derive ratios and per share values on an aggregate level. The resulting index values can be used to identify market trends and compare a combination of portfolios, benchmarks, and individual securities. summary: Factset Market aggregate data for ETPs. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Ticker-region of an ETP as defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Market Aggregates type: object x-property-sort: - asOfDate - optionAdjustedSpread - averageLife properties: asOfDate: type: string format: date description: >- Date the analytics data was published. Available for the regions: US, Europe,and Canada. optionAdjustedSpread: description: >- Option-adjusted spread (OAS) value of the ETP; measurement of the yield spread calculated after removing any embedded options providing users with a spread of an option-free bond. type: object x-property-sort: - range0 - range0To100 - range100To200 - range200To300 - range300To400 - range400To500 - range500To600 - range600To700 - range700To800 - range800To900 - range900To1000 - range1000Plus properties: range0: type: number format: percentage x-convertToRelative: false description: OAS value of the ETP. range0To100: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETP ranges between 0 to 99.9. range100To200: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETP ranges between 100 to 199.99. range200To300: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETP ranges between 200 to 299.99. range300To400: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 300 to 399.99. range400To500: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 400 to 499.99. range500To600: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 500 to 599.99. range600To700: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 600 to 699.99. range700To800: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 700 to 799.99. range800To900: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 800 to 899.99. range900To1000: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges between 900 to 999.99. range1000Plus: type: number format: percentage x-convertToRelative: false description: OAS weight of the ETF ranges above 1000. averageLife: description: Average life type: object x-property-sort: - span - span0To1 - span1To2 - span2To3 - span3To5 - span5To7 - span7To10 - span10To15 - span15To20 - span20Plus properties: span: type: number format: percentage x-convertToRelative: false description: Average life value of the ETP. span0To1: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 0 and 1 years. span1To2: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 1 and 2 years. span2To3: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 2 and 3 years. span3To5: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 3 and 5 years. span5To7: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 5 and 7 years. span7To10: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 7 and 10 years. span10To15: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 10 and 15 years. span15To20: type: number format: percentage x-convertToRelative: false description: >- Average life value of the ETP ranges between 15 and 20 years. span20Plus: type: number format: percentage x-convertToRelative: false description: Average life value of the ETP ranges above 20 years. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/premiumDiscount/summary/listBySymbol: get: tags: - Factset operationId: get/factset/etf/premiumDiscount/summary/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: Summary of ETP premium discount data. summary: Factset Summary of ETP premium discount data. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: timePeriod in: query type: string required: false default: YTD description: Time frame of the data. x-enum-description: - Year to date. - Two year. - Three year. - Five years. enum: - YTD - 2Y - 3Y - 5Y - name: alignment in: query type: string required: false default: quarter-end description: >- Indicates the reference point for the historical NAV and price values. x-enum-description: - >- Premium/discount/neutral data is shown relative to ETP's NAV and price at the most recent end-of-month. - >- Premium/discount/neutral data is shown relative to ETP's NAV and price at the most recent end-of-quarter. - >- Premium/discount/neutral data is shown relative to ETP's NAV and price at the most recent end-of-year. enum: - month-end - quarter-end - year-end - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: description: ETP's premium discount summary data. type: object x-property-sort: - asOfDate - summary properties: asOfDate: type: string format: date description: As of date of the premium discount summary data. summary: type: array items: type: object x-property-sort: - reportDate - count properties: reportDate: type: string format: date description: Report date of premium/discount/neutral count. count: type: object x-property-sort: - premium - discount - neutral description: Count of premium, disount and neutral. properties: premium: type: number format: int32 description: Number of days ETP is traded at premium. discount: type: number format: int32 description: Number of days ETP is traded at discount. neutral: type: number format: int32 description: >- Number of days ETP is neither traded at discount nor at premium. uniqueItems: true description: Summary of premium/discout/neutral data. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination /factset/etf/price/getBySymbol: get: tags: - Factset operationId: get/factset/etf/price/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve an ETP's historical NAV and shares outstanding for a specified time range. summary: Factset Retrieve historical ETP NAV values. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Price. type: object x-property-sort: - nav - sharesOutstanding properties: nav: description: Nav. type: object x-property-sort: - value - currency - startDate - last - totalReturn properties: value: type: number format: real description: >- Daily net asset value (NAV) of the ETP. This data is available for all the regions. currency: type: string description: >- Currency of the ETP's NAV in ISO 4217 format. This data is available for all the regions. x-enum-description: - Swiss franc. - Canadian dollar. - United States dollar. - Euro. - Mexican peso. - Pound sterling. - Penny sterling. - Swedish krona/kronor. - Japanese yen. enum: - CHF - CAD - USD - EUR - MXN - GBP - GBX - SEK - JPY startDate: type: string format: date description: >- Date of first available NAV ex-date. This data is available for all the regions. last: description: Last. type: object x-property-sort: - value - date properties: value: type: number format: real description: >- Last available NAV value, in case of the daily NAV value is missing. This data is available for all the regions. date: type: string format: date description: >- Date of last available NAV. This data is available for all the regions. totalReturn: type: number format: real description: >- ETP NAV calculated by reinvesting dividends and compounding returns. This data is available for all the regions. sharesOutstanding: description: Shares outstanding. type: object x-property-sort: - value - lastValue - earliestDate properties: value: type: number format: real description: >- Daily shares outstanding (i.e., actual values) for a ETP. This data is available for all the regions. lastValue: type: number format: real description: >- Last available shares outstanding for a ETP. This data is available for all the regions. earliestDate: type: string format: date description: >- Returns the earliest date for which a shares outstanding figure is available. This data is available for all the regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/returns/getBySymbol: get: tags: - Factset operationId: get/factset/etf/returns/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- An ETP's total return data can be returned for various time frames including 1-month, 3-month, YTD, 1-year, 3-year, and 5-year. Total return calculations include price performance plus reinvested and compounded distributions. Market price is used to calcualte market returns. Portfolio nav is used to calcualte nav returns. summary: Factset Retrieve total return data for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: returnType in: query type: string maxLength: 5 exclusiveMaximum: false required: false default: price description: Return type. x-enum-description: - Price Returns. - NAV Returns. enum: - price - nav - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Returns. type: object x-property-sort: - return1M - return3M - returnYTD - return1Y - return3Y - return5Y properties: return1M: type: number format: real description: >- 1 month performance. This data is available for the US regions. return3M: type: number format: real description: >- 3 month performance. This data is available for the US regions. returnYTD: type: number format: real description: >- YTD performance. This data is available for the US regions. return1Y: type: number format: real description: >- 1 year performance. This data is available for the US regions. return3Y: type: number format: real description: >- 3 year performance. This data is available for the US regions. return5Y: type: number format: real description: >- 5 year performance. This data is available for the US regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/strategy/getBySymbol: get: tags: - Factset operationId: get/factset/etf/strategy/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- ETP's can be classified in many different ways including investment strategy, security weightings, and fund composition. summary: Factset Retrieve various classification details for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Strategy. type: object x-property-sort: - description - group - cluster - selectCriteria - weighting - segment - isTransparent - fundOfFunds properties: description: type: string description: >- Descriptive Summary of the methods used by a ETP or its index in selection and weighting of its holdings, text and standardized value available. This data is available for the US and Canada regions. group: type: string description: >- Factset's strategy group is the broadest way sort ETPs with a similar investment strategy. This data is available for the US and Canada regions. cluster: type: string description: >- Factset's strategy cluster is a collection of ETPs with a similar investment strategy, yet smaller than strategy group. This data item is more granular and narrow than the strategy group yet bigger than strategy group. This data is available for the US and Canada regions. selectCriteria: type: string description: >- Description of the security selection criteria used by the ETP or its index (e.g., Market Cap, Earnings, Dividends), text and standardized value available. This data is available for all the regions. weighting: type: string description: >- Text that specifies the weighting selection criteria used by the ETP or its index (e.g., Market Cap, Equal, Momentum, Fundamental) , text and standardized value available. This data is available for all the regions. segment: type: string description: >- Determines the unique segment the ETP falls into, based on FactSet ETP Analytics rules-based classification system determined by geography, category, focus, and niche. Text and standardized value available for this data item. This data is available for the US regions. See endpoint /factset/etf/strategy/segment/list for possible values. isTransparent: type: boolean description: >- Description that States whether or not the methodology behind the underlying index can be clearly understood from offering documents. This data is available for the US and Canada regions. fundOfFunds: type: string description: >- Description of the ETP that holds a portfolio of other ETPs. This data is available for the Canada regions. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/strategy/segment/list: get: tags: - Factset operationId: get/factset/etf/strategy/segment/list x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve the various segments assigned to a specific ETP. Segment data is used to group funds for comparison and relative performance analyses. summary: Factset Retrieve a list of ETP strategy segments. responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - name properties: name: type: string description: Name of the segment. uniqueItems: true description: List of strategy segments. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination parameters: - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 500 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query /factset/etf/structure/getBySymbol: get: tags: - Factset operationId: get/factset/etf/structure/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve details on a fund's structure including its type, investment style (active/passive), and legal structure. summary: Factset Retrieve the basic structure information for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Structure. type: object x-property-sort: - isEtn - type - isActivelyManaged - backing - syntheticType - legalStructure - isUcitsCompliant - isHoldingsTransparent - portfolioDisclosure - cashFlowFrequency - isEligibleForRegisteredAccounts - isDripEligible properties: isEtn: type: boolean description: >- Flags exchange-traded notes. This data is available for all the regions. type: type: string description: >- Describes the legal structure of the ETP, text and standardized value available. This data is available for all the regions. isActivelyManaged: type: boolean description: >- Flags ETPs that are actively managed as per SEC guidelines. This data is available for all the regions. backing: type: string description: >- Describes whether the ETP holds underlying securities or uses derivatives to gain its desired exposure, text and standardized value available. This data is available for all the regions. syntheticType: type: string description: >- Indicates whether the synthetic ETP is “unfunded” (collateral or substitute basket of securities for the swap agreement is owned by ETP), or “funded” (collateral for swap agreement is held by a custodian in the name of the ETP or in the name of the counterparty, pledged to the ETP issuer), text and standardized value available. This data is available for Europe only. legalStructure: type: string description: >- The organizational structure of the ETP, text and standardized value available. This data is available for all the regions. isUcitsCompliant: type: boolean description: >- The counterparty for derivative exposure for synthetic ETPs. This data is available for all the regions. isHoldingsTransparent: type: boolean description: >- States whether or not the ETP's issuer discloses its positions on its website daily. This data is available for all the regions. portfolioDisclosure: type: string description: >- The frequency of an issuer's disclosure of all ETP holdings on its website, text and standardized value available. This data is available for all the regions. cashFlowFrequency: type: string description: >- States how often the ETP makes regular distributions, text and standardized value available. This data is available only for US and Europe. isEligibleForRegisteredAccounts: type: boolean description: >- Product can be held in tax-advantaged investment accounts. This data is available for Canada only. isDripEligible: type: boolean description: >- Ability to have dividends reinvested. This data is available for Canada only. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/taxesAndFees/us/getBySymbol: get: tags: - Factset operationId: get/factset/etf/taxesAndFees/us/getBySymbol x-supportsOffsetBasedPaging: false x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve various fee and tax related details on a specified ETP including expense ratio and tax treatment for dividends and capital gains. summary: Factset Retrieve the tax and fee related information for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. responses: '200': description: Successful Response schema: type: object properties: data: description: Taxes and fees. type: object x-property-sort: - maxCapitalGainsRate - dividendTreatment - distributeK1 - taxType - taxOnDistributions - expenseRatio - potentialCostIncreaseDate - contractAdvisoryFee - capitalGains - capitalGainsDistirbutions3Y - managementExpenseRatio - managementFee - tradingExpenseRatio - feeWaiver properties: maxCapitalGainsRate: description: Max capital gains rate. type: object x-property-sort: - longTerm - shortTerm properties: longTerm: type: number format: real description: >- The maximum US federal personal income tax rate that applies to long-term capital gains associated with the ETP. This data is available for the US regions. shortTerm: type: number format: real description: >- The maximum US federal personal income tax rate that applies to short-term capital gains associated with the ETP. This data is available for the US regions. dividendTreatment: type: string description: >- Describes whether dividend income received by the ETP is distributed to ETP shareholders or capitalised (reinvested) into the ETP, text and standardized value available. This data is available for all the Canada and Europe regions. distributeK1: type: string description: >- Flags ETPs that distribute K-1 tax forms. This data is available for the US regions. taxType: type: string description: >- Type of the tax applicable on the distribution. This data is available for the US regions. taxOnDistributions: type: string description: >- Tax treatment of the ETP's regular distributions. This data is available for the US regions. expenseRatio: description: Expense ratio. type: object x-property-sort: - value - potential properties: value: type: number format: real description: >- Typically the net total annual fee the issuer deducts from ETP assets as a management fee. Also can include where applicable acquired ETP fees, short interest expense, index fees, and financing fees. Breakeven rate is reported for commodity pools. This data is available for all the regions. potential: type: number format: real description: >- The full expense ratio before any fee waivers. This data is available fo the US and Canada regions. potentialCostIncreaseDate: type: string format: date description: >- Expiration date of any fee waivers. This data is available for the US and Canada regions. contractAdvisoryFee: type: number format: real description: >- The advisors fee excluding any additional costs or fees; A subset of the total expense ratio. This data is available for the Canada regions. capitalGains: type: number format: real description: >- Realized capital gains or losses reported on the ETP's most recent annual or semi-annual report. Gains must generally be paid out as a distribution at year-end, while losses can be banked to offset future gains. This data is available only for the US regions. capitalGainsDistirbutions3Y: type: number format: real description: >- The average annual capital gains paid out to shareholders over the past 3 calendar years, measured as a percent of net asset value (NAV) on the final trading day of each previous year. This data is available for the US region only. managementExpenseRatio: type: number format: real description: >- Total net annual cost associated with holding the ETP, expressed as a percentage. This data is available for the Canada regions. managementFee: type: number format: real description: >- Annual fee collected by fund manager, expressed as a percentage. This data is available for the Canada region. tradingExpenseRatio: type: number format: real description: >- Estimated annual costs associated with trading the underlying holdings. This data is available for the Canada region. feeWaiver: type: string description: >- A reduction in annual ETP expenses, expressed as a percentage. This data is available for the Canada region. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' x-property-sort: - status /factset/etf/timeSeries/listBySymbol: get: tags: - Factset operationId: get/factset/etf/timeSeries/listBySymbol x-supportsOffsetBasedPaging: true x-supportsOffsetBasedPagingWithoutTotal: false x-supportsCursorBasedPaging: false x-supportsCursorBasedPagingWithoutTotal: false x-supportsPush: false x-requiresUser: false x-requiresInternalClient: false x-disallowUser: false x-no-merge: false x-maxSortParameterCount: 10 x-supportsPermissionDeniedResponse: false description: >- Retrieve the historical NAV data and the respective fund flows and shares outstanding for a specified fund and time period. Please refer currency.fund in /factset/etf/getBySymbol for currency value. summary: Factset Retrieve historical NAV data for a specified ETP. parameters: - name: symbol in: query type: string maxLength: 10 exclusiveMaximum: false required: true description: Market symbol of ETP defined by FactSet. - name: timePeriod in: query type: string required: false default: 1Y description: Time frame of the data. x-enum-description: - One month. - Three months. - Six months. - Year to date. - One year. - Two year. - Three year. - Five years. - Ten years. - Since Inception. enum: - 1M - 3M - 6M - YTD - 1Y - 2Y - 3Y - 5Y - 10Y - SI - name: alignment in: query type: string required: false description: Indicates the reference point for the time series data. x-enum-description: - >- Time series data is shown relative to the most recent (usually daily) end-of-day NAV. - >- Time series data is shown relative to the NAV at the most recent end-of-week. - >- Time series data is shown relative to the NAV at the most recent end-of-month. enum: - day - week-end - month-end - name: _attributes in: query type: array items: type: string maxLength: 100 exclusiveMaximum: false uniqueItems: true maxItems: 50 collectionFormat: csv description: Limit the attributes returned in the response to the specified set. - type: number format: int32 minimum: 0 exclusiveMinimum: false default: 0 description: Non-negative number of entries to skip, or 0 (default). name: _paginationOffset in: query - type: number format: int32 minimum: 0 exclusiveMinimum: false maximum: 1000 exclusiveMaximum: false default: 20 description: Non-negative maximum number of entries to return. name: _paginationLimit in: query responses: '200': description: Successful Response schema: type: object properties: data: type: array items: type: object x-property-sort: - navDate - nav - navChange - navChangePercent - premiumDiscount - fundFlows - sharesOutstanding - aum properties: navDate: type: string format: date description: Historice NAV date value. nav: type: number format: real description: Returns historic Net Asset Value of the ETP. navChange: type: number format: real description: Absolute change in NAV value. navChangePercent: type: number format: real description: Related change in the NAV value. premiumDiscount: type: number format: real description: Difference between market price and NAV of the ETP. fundFlows: type: number format: real description: >- This value returns factset's ETF fundflow history. Rolling one day fund flows are calculated using the difference of shares outstanding at previous close and shares outstanding one day prior to close mulitplied by the NAV of one day prior to close. sharesOutstanding: type: number format: real description: >- Returns the historic share Outstanding values of the ETP. aum: type: number format: real description: Returns the historic Total Asset Value of the ETP. uniqueItems: true description: Time series. meta: type: object description: The meta member contains the meta information of the response. properties: status: $ref: '#/definitions/StatusObject' pagination: $ref: '#/definitions/OffsetBasedPaginationOutputObject' x-property-sort: - status - pagination info: title: Factset Prime Developer Trial version: v1 x-interface-version: 1 x-documenter-version: 5.38.1 x-api-version: 2.9.1 tags: - name: Factset description: factset endpoints responses: ErrorResponse: description: Generic error response for all errors (400 ... 599 error codes) schema: type: object properties: meta: $ref: '#/definitions/ErrorMetaObject' errors: $ref: '#/definitions/ErrorObject' definitions: ErrorMetaObject: type: object properties: status: $ref: '#/definitions/StatusObject' ErrorObject: type: array description: The errors member contains additional information about a failed request. items: type: object properties: details: type: string description: >- A human-readable, unstructured explanation specific to this occurrence of the failure. encryptedDetails: type: string description: >- Base64-encoded, internal details about the error, in addition to "details". type: type: number format: int32 description: Internal error type of the Foundation API protocol. attribute: type: array description: >- For a validation error, a reference to the request parameter that failed validation; otherwise, an empty array. items: type: object properties: name: type: string description: Element of the path denoting the request parameter. index: type: number format: int32 description: >- If the attribute "name" designates an array, index of the array element; otherwise the special value -1. x-property-sort: - name - index x-property-sort: - detail - encryptedDetails - type - attribute AttributesMember: type: array description: Limit the attributes returned in the response to the specified set. items: type: string maxLength: 100 exclusiveMaximum: false maxItems: 50 uniqueItems: true LanguageMember: type: string format: isoLanguage description: ISO 639-1 code of the language. maxLength: 2 minLength: 2 exclusiveMinimum: false exclusiveMaximum: false StatusObject: type: object properties: code: type: number format: int32 description: >- The HTTP status code of the response, mirroring the code from the Status-Line of the HTTP response message (see [RFC2616] section 6.1). description: The status member contains the status code of the response. required: - code CursorBasedPaginationOutputObject: type: object description: Pagination attributes for the cursor-based pagination strategy. properties: total: type: number format: int32 description: Total number of entries in the result set. isEstimatedTotal: type: boolean description: Flag indicating that the value of `total` is estimated. next: type: string description: >- The next cursor position to use in the parameter `pagination.cursor` for an endpoint that supports cursor-based pagination, otherwise `null`. previous: type: string description: >- The previous cursor position to use in the parameter `pagination.cursor` for an endpoint that supports cursor-based pagination. If a previous cursor position is not supported or available, `previous` is `null`. required: - total - isEstimatedTotal - next - previous x-property-sort: - total - isEstimatedTotal - next - previous CursorBasedPaginationOutputObjectWithoutTotal: type: object description: >- Pagination attributes for the cursor-based pagination strategy; a total element count is not supported. properties: next: type: string description: >- The next cursor position to use in the parameter `pagination.cursor` for an endpoint that supports cursor-based pagination, otherwise `null`. previous: type: string description: >- The previous cursor position to use in the parameter `pagination.cursor` for an endpoint that supports cursor-based pagination. If a previous cursor position is not supported or available, `previous` is `null`. required: - next - previous x-property-sort: - next - previous OffsetBasedPaginationOutputObject: type: object description: Pagination attributes for the offset-based pagination strategy. properties: total: type: number format: int32 description: Total number of entries in the result set. isEstimatedTotal: type: boolean description: Flag indicating that the value of "total" is estimated. required: - total - isEstimatedTotal x-property-sort: - total - isEstimatedTotal OffsetBasedPaginationOutputObjectWithoutTotal: type: object description: >- Pagination attributes for the offset-based pagination strategy; a total element count is not supported. properties: hasNext: type: boolean description: >- Flag indicating that a subsequent request with the same parameters, except that the parameter `pagination.offset` is incremented by `pagination.limit`, would yield additional results. required: - hasNext x-property-sort: - hasNext PartialOutputObject: type: object properties: isPartial: type: boolean description: >- Flag indicating that the response is a possibly incomplete array or an object containing a possibly incomplete array, due to hitting a processing time limit. If `true`, some matching results might be missing from the array, or elements for matching results might be incorrectly included (for example, when priority sorting would have removed the element). Depending on the use case, such a response may be unsuitable. description: Object denoting that the endpoint response is possibly incomplete. required: - isPartial x-property-sort: - isPartial basePath: /wealth/v1 schemes: - https securityDefinitions: Basic: type: basic security: - Basic: []