Factset
FactSet ETF Profile and Prices API

Access FactSet-collected profile data and pricing for Exchange Traded Funds (ETFs).
Documentation GitHub OpenAPI
OpenAPI Specification

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
                      propert

# --- truncated at 32 KB (192 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/factset/refs/heads/main/openapi/etf-profile-and-prices-openapi-original.yml
FactSet ETF Profile and Prices API

Documentation

Specifications

SDKs

Code Examples

Other Resources

OpenAPI Specification
