Factset Factset API

openapi: 3.2.0
info:
  title: Factset API
  version: '1.0'
  description: 'Operations tagged Factset across 2 of this provider''s published API definitions: etf-profile-and-prices-openapi-original.yml, factset-esg-api-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.factset.com/wealth/v1
- url: https://api.factset.com/content
  description: Production
tags:
- name: Factset
  description: factset endpoints
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
        required: true
        description: Market symbol of ETP defined by FactSet.
        schema:
          type: string
          maxLength: 10
      - name: _attributes
        in: query
        description: Limit the attributes returned in the response to the specified set.
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            maxLength: 100
          maxItems: 50
          uniqueItems: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              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: '#/components/schemas/StatusObject'
                    x-property-sort:
                    - status
      security:
      - Basic: []
    servers:
    - url: https://api.factset.com/wealth/v1
  /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
        required: true
        description: Market symbol of ETP defined by FactSet.
        schema:
          type: string
          maxLength: 10
      - name: _attributes
        in: query
        description: Limit the attributes returned in the response to the specified set.
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            maxLength: 100
          maxItems: 50
          uniqueItems: true
      - description: Non-negative number of entries to skip, or 0 (default).
        name: _paginationOffset
        in: query
        schema:
          type: number
          format: int32
          default: 0
          minimum: 0
      - description: Non-negative maximum number of entries to return.
        name: _paginationLimit
        in: query
        schema:
          type: number
          format: int32
          default: 20
          maximum: 500
          minimum: 0
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              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: '#/components/schemas/StatusObject'
                      pagination:
                        $ref: '#/components/schemas/OffsetBasedPaginationOutputObject'
                    x-property-sort:
                    - status
                    - pagination
      security:
      - Basic: []
    servers:
    - url: https://api.factset.com/wealth/v1
  /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
        required: true
        description: Market symbol of ETP defined by FactSet.
        schema:
          type: string
          maxLength: 10
      - name: _attributes
        in: query
        description: Limit the attributes returned in the response to the specified set.
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            maxLength: 100
          maxItems: 50
          uniqueItems: true
      - description: Non-negative number of entries to skip, or 0 (default).
        name: _paginationOffset
        in: query
        schema:
          type: number
          format: int32
          default: 0
          minimum: 0
      - description: Non-negative maximum number of entries to return.
        name: _paginationLimit
        in: query
        schema:
          type: number
          format: int32
          default: 20
          maximum: 500
          minimum: 0
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              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: '#/components/schemas/StatusObject'
                      pagination:
                        $ref: '#/components/schemas/OffsetBasedPaginationOutputObject'
                    x-property-sort:
                    - status
                    - pagination
      security:
      - Basic: []
    servers:
    - url: https://api.factset.com/wealth/v1
  /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
        required: true
        description: Market symbol of ETP defined by FactSet.
        schema:
          type: string
          maxLength: 10
      - name: _attributes
        in: query
        description: Limit the attributes returned in the response to the specified set.
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            maxLength: 100
          maxItems: 50
          uniqueItems: true
      - description: Non-negative number of entries to skip, or 0 (default).
        name: _paginationOffset
        in: query
        schema:
          type: number
          format: int32
          default: 0
          minimum: 0
      - description: Non-negative maximum number of entries to return.
        name: _paginationLimit
        in: query
        schema:
          type: number
          format: int32
          default: 20
          maximum: 500
          minimum: 0
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              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: '#/components/schemas/StatusObject'
                      pagination:
                        $ref: '#/components/schemas/OffsetBasedPaginationOutputObject'
                    x-property-sort:
                    - status
                    - pagination
      security:
      - Basic: []
    servers:
    - url: https://api.factset.com/wealth/v1
  /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
        required: true
        description: Market symbol of ETP defined by FactSet.
        schema:
          type: string
          maxLength: 10
      - name: _attributes
        in: query
        description: Limit the attributes returned in the response to the specified set.
        style: form
        explode: false
        schema:
          type: array
          items:
            type: string
            maxLength: 100
          maxItems: 50
          uniqueItems: true
      - description: Non-negative number of entries to skip, or 0 (default).
        name: _paginationOffset
        in: query
        schema:
          type: number
          format: int32
          default: 0
          minimum: 0
      - description: Non-negative maximum number of entries to return.
        name: _paginationLimit
        in: query
        schema:
          type: number
          format: int32
          default: 20
          maximum: 500
          minimum: 0
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              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:
       

# --- truncated at 32 KB (436 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/factset/refs/heads/main/openapi/factset-factset-api-openapi.yml