Skip to content

Technical indicators tools

technical_indicators_tools

Functions:

Name Description
get_indicators

Retrieve technical indicators for a given ticker symbol.

get_indicators 

get_indicators(
    symbol: str, indicator: str | list[str], curr_date: str, look_back_days: int = 30
) -> str

Retrieve technical indicators for a given ticker symbol.

Parameters:

Name Type Description Default

symbol

str

Stock ticker, company symbol, or Taiwan stock code. Examples: AAPL, TSM, 2330.TW, 2330, 8069.

 required

indicator

str | list[str]

One or more technical indicators. May be a single indicator name, a Python list of names, or a comma-separated string like "macd,rsi,close_50_sma".

 required

curr_date

str

The current trading date in YYYY-MM-DD format.

 required

look_back_days

int

Number of days to look back. Defaults to 30.

 30

Returns:

Name Type Description
str str

A formatted report for one indicator, or multiple sections when several indicators are requested.

Raises:

Type Description
ValueError

If no valid indicators are provided, an indicator is unsupported, or no market data is available for the symbol.
Source code in src/tradingagents/agents/utils/technical_indicators_tools.py 
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
@tool
def get_indicators(
    symbol: Annotated[str, "ticker symbol of the company"],
    indicator: Annotated[
        str | list[str],
        "One or more technical indicators. Accepts a single indicator name, a list of names, or a comma-separated string.",
    ],
    curr_date: Annotated[str, "The current trading date you are trading on, YYYY-MM-DD"],
    look_back_days: Annotated[int, "how many days to look back"] = 30,
) -> str:
    """Retrieve technical indicators for a given ticker symbol.

    Args:
        symbol (str): Stock ticker, company symbol, or Taiwan stock code.
            Examples: AAPL, TSM, 2330.TW, 2330, 8069.
        indicator (str | list[str]): One or more technical indicators. May be a
            single indicator name, a Python list of names, or a comma-separated
            string like "macd,rsi,close_50_sma".
        curr_date (str): The current trading date in YYYY-MM-DD format.
        look_back_days (int, optional): Number of days to look back. Defaults
            to 30.

    Returns:
        str: A formatted report for one indicator, or multiple sections when
            several indicators are requested.

    Raises:
        ValueError: If no valid indicators are provided, an indicator is
            unsupported, or no market data is available for the symbol.
    """
    if isinstance(indicator, str):
        indicators = [ind.strip() for ind in indicator.split(",") if ind.strip()]
    else:
        indicators = [ind.strip() for ind in indicator if ind and ind.strip()]

    if not indicators:
        raise ValueError("At least one indicator must be provided.")

    if len(indicators) == 1:
        return get_stock_stats_indicators_window(symbol, indicators[0], curr_date, look_back_days)

    sections = []
    for ind in indicators:
        report = get_stock_stats_indicators_window(symbol, ind, curr_date, look_back_days)
        sections.append(f"## {ind}\n{report}")
    return "\n\n".join(sections)