python-tradingview-ta

You can use TA_Handler to build a trading bot by continuously polling for recommendations and executing logic based on the RECOMMENDATION field.

Important Considerations:

• Risk: Trading with bots is highly risky. Always use paper trading before using real funds.
• State Management: The last_order variable in the example below is stored in memory. If the program exits, the state is lost, and the bot will default to creating a new buy order upon restart.
• Timing: The time.sleep() duration should ideally match the interval used in the TA_Handler to avoid redundant requests.

# Import packages.
from tradingview_ta import TA_Handler, Interval, Exchange
import time

# Store the last order.
last_order = "sell"

# Instantiate TA_Handler.
handler = TA_Handler(
    symbol="SYMBOL",
    exchange="EXCHANGE",
    screener="SCREENER",
    interval="INTERVAL",
)

# Repeat forever.
while True:
    # Retrieve recommendation.
    rec = handler.get_analysis()["RECOMMENDATION"]

    # Create a buy order if the recommendation is "BUY" or "STRONG_BUY" and the last order is "sell".
    # Create a sell order if the recommendation is "SELL" or "STRONG_SELL" and the last order is "buy".
    if "BUY" in rec and last_order == "sell":
        # REPLACE COMMENT: Create a buy order using your exchange's API.
        last_order = "buy"
    elif "SELL" in rec and last_order == "buy":
        # REPLACE COMMENT: Create a sell order using your exchange's API.
        last_order = "sell"

    # Wait for x seconds before retrieving new analysis.
    # The time should be the same as the interval.
    time.sleep(x)

To fetch technical analysis data, instantiate a TA_Handler with the required market parameters and call .get_analysis().summary.

Parameters:

• symbol: The ticker symbol (e.g., "TSLA").
• screener: The market screener (e.g., "america").
• exchange: The exchange name (e.g., "NASDAQ").
• interval: An Interval enum value (e.g., Interval.INTERVAL_1_DAY).
• proxies (optional): A dictionary to enable proxy support, e.g., {'http': 'http://example.com:8080'}.

Output Format: The .summary attribute returns a dictionary containing the recommendation and counts for BUY, NEUTRAL, and SELL signals. Example: {"RECOMMENDATION": "BUY", "BUY": 8, "NEUTRAL": 6, "SELL": 3}.

Tip: If you are unsure of the correct symbol, screener, or exchange values, use https://tvdb.analyzer.rest/ to look them up.

from tradingview_ta import TA_Handler, Interval, Exchange

tesla = TA_Handler(
    symbol="TSLA",
    screener="america",
    exchange="NASDAQ",
    interval=Interval.INTERVAL_1_DAY,
    # proxies={'http': 'http://example.com:8080'} # Uncomment to enable proxy (replace the URL).
)
print(tesla.get_analysis().summary)
# Example output: {"RECOMMENDATION": "BUY", "BUY": 8, "NEUTRAL": 6, "SELL": 3}

Calling handler.get_analysis() returns an Analysis object containing technical data.

Key Attributes of the Analysis object:

• summary (dict): Combined recommendation from oscillators and moving averages. Example: {'RECOMMENDATION': 'BUY', 'BUY': 12, 'SELL': 7, 'NEUTRAL': 9}.
• oscillators (dict): Analysis based specifically on oscillators (includes a COMPUTE key with individual indicator results).
• moving_averages (dict): Analysis based specifically on moving averages (includes a COMPUTE key with individual indicator results).
• indicators (dict): Raw technical indicator values (e.g., RSI, MACD, EMA, SMA).
• time (datetime.datetime): The timestamp of the retrieved data.

Commonly used indicators:

• Opening price: analysis.indicators["open"]
• Closing price: analysis.indicators["close"]
• Momentum: analysis.indicators["Mom"]
• RSI: analysis.indicators["RSI"]
• MACD: analysis.indicators["MACD.macd"]

analysis = handler.get_analysis()