# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Twelve Data Mutual Funds API
  version: 1.0.0
extends: openapi/twelvedata-mutual-funds-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-10-01'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 11
- target: $.paths['/mutual_funds/family'].get
  update:
    x-apievangelist-phrasing:
      intent: List mutual fund families
      effect: read
      questions:
      - Which investment companies manage mutual fund families in this country?
      - What mutual fund families are available to filter by?
      instructions:
      - text: List mutual fund families in {country}.
        slots:
          country: query.country
      - text: Check whether {fund_family} is a listed mutual fund family.
        slots:
          fund_family: query.fund_family
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/list'].get
  update:
    x-apievangelist-phrasing:
      intent: Browse the mutual funds directory
      effect: read
      questions:
      - Which are the largest mutual funds by total assets?
      - Can I filter mutual funds by performance rating or risk rating?
      instructions:
      - text: List mutual funds in {country}, largest first.
        slots:
          country: query.country
      - text: Find mutual funds with a performance rating of {performance_rating}.
        slots:
          performance_rating: query.performance_rating
      - text: Show mutual funds from {fund_family} with risk rating {risk_rating}.
        slots:
          fund_family: query.fund_family
          risk_rating: query.risk_rating
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/type'].get
  update:
    x-apievangelist-phrasing:
      intent: List mutual fund types
      effect: read
      questions:
      - What types of mutual funds exist, such as equity, bond or balanced?
      - Which mutual fund categories are offered in a given country?
      instructions:
      - text: List the mutual fund types in {country}.
        slots:
          country: query.country
      - text: Check whether {fund_type} is a mutual fund type.
        slots:
          fund_type: query.fund_type
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world'].get
  update:
    x-apievangelist-phrasing:
      intent: Get full data for a mutual fund
      effect: read
      questions:
      - Can I get a mutual fund's performance, risk, ratings and composition all together?
      - Where do I get the complete dataset for one mutual fund?
      instructions:
      - text: Get the full mutual fund profile for {symbol}.
        slots:
          symbol: query.symbol
      - text: Pull every available data section for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/composition'].get
  update:
    x-apievangelist-phrasing:
      intent: See a mutual fund's holdings and sector mix
      effect: read
      questions:
      - What does this mutual fund actually hold?
      - How is a mutual fund's portfolio split across sectors?
      instructions:
      - text: Show the holdings and sector allocation for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: List the weighted positions inside mutual fund {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/performance'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a mutual fund's historical returns
      effect: read
      questions:
      - What are this mutual fund's trailing and quarterly returns?
      - Are load-adjusted returns available for a mutual fund?
      instructions:
      - text: Get the performance history for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: Show annual, quarterly and load-adjusted returns for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/purchase_info'].get
  update:
    x-apievangelist-phrasing:
      intent: Get minimum investment and where to buy a fund
      effect: read
      questions:
      - What is the minimum investment to buy into this mutual fund?
      - Which brokerages sell a particular mutual fund?
      instructions:
      - text: Get the purchase information for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: Show the minimum investment and brokerages for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/ratings'].get
  update:
    x-apievangelist-phrasing:
      intent: Get ratings for a mutual fund
      effect: read
      questions:
      - How is this mutual fund rated by Twelve Data and other institutions?
      - What quality ratings has a mutual fund received?
      instructions:
      - text: Get the ratings for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: Show in-house and third-party ratings for the fund with ISIN {isin}.
        slots:
          isin: query.isin
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/risk'].get
  update:
    x-apievangelist-phrasing:
      intent: Get risk metrics for a mutual fund
      effect: read
      questions:
      - What is the Sharpe ratio and standard deviation of this mutual fund?
      - How risky is a mutual fund compared with the market, by beta?
      instructions:
      - text: Get the risk metrics for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: Show beta, Sharpe ratio and standard deviation for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/summary'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a quick overview of a mutual fund
      effect: read
      questions:
      - What is a short overview of this mutual fund's asset class and region?
      - Can I see a mutual fund's headline details without the full dataset?
      instructions:
      - text: Give me the summary overview of mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: Show the basic facts summary for mutual fund {symbol} in {country}.
        slots:
          symbol: query.symbol
          country: query.country
      method: generated
      generated: '2026-10-01'
- target: $.paths['/mutual_funds/world/sustainability'].get
  update:
    x-apievangelist-phrasing:
      intent: Get ESG and sustainability ratings for a fund
      effect: read
      questions:
      - What is the ESG score of this mutual fund?
      - How sustainable is a mutual fund by environmental, social and governance measures?
      instructions:
      - text: Get the sustainability and ESG data for mutual fund {symbol}.
        slots:
          symbol: query.symbol
      - text: Show the ESG scores for the mutual fund with ISIN {isin}.
        slots:
          isin: query.isin
      method: generated
      generated: '2026-10-01'