Technical Chart icon

Technical Chart

Generate technical charts using remote browser and save as images
Join our community

Overview

This node generates technical trading charts by connecting to a remote browser instance via a WebSocket endpoint and loading TradingView chart pages. It automates the process of rendering charts for specified trading pairs, timeframes, and themes, then captures the chart as an image (base64 encoded) along with optional data such as technical indicators, OHLCV (Open, High, Low, Close, Volume) data, and custom study data.

Common scenarios where this node is beneficial include:

  • Automating the generation of up-to-date trading charts for use in reports or dashboards.
  • Extracting technical analysis data programmatically from TradingView charts.
  • Integrating chart images and related data into trading bots or alert systems.

Practical example:

  • A user wants to generate a 1-hour BTC/USDT futures chart with a dark theme, including technical indicators and OHLCV data, then save the chart image and data for further analysis or sharing.

Properties

Name Meaning
Browser WebSocket Endpoint WebSocket URL to connect to a remote browser instance (e.g., Puppeteer). This enables headless browser automation remotely.
TradingView Endpoint Base URL of the TradingView chart page to load (default: https://www.tradingview.com/chart).
Symbol Trading pair symbol to display on the chart (e.g., BTC/USDT, ETH/USDT).
Timeframe Chart timeframe interval. Options include: 1 Day, 1 Hour, 1 Minute, 1 Month, 1 Week, 12 Hours, 15 Minutes, 2 Hours, 30 Minutes, 4 Hours, 5 Minutes, 6 Hours, 8 Hours.
Theme Chart color theme. Options: Light, Dark.
Chart Width Width of the chart image in pixels (min 800, max 3840).
Chart Height Height of the chart image in pixels (min 600, max 2160).
Layout Optional chart layout identifier string.
Study Optional technical analysis study identifier to apply on the chart.
Market Market type for the chart. Options: Futures, Spot.
Bot Mode Boolean flag to enable bot mode, which adds a query parameter mode=bot to the TradingView URL.
Output Options Collection of output-related options:
• Extract Study Custom Data (boolean): extract custom study data.
• Include Base64 (boolean): include base64 image data.
• Include Indicators (boolean): include indicator data.
• Include OHLCV (boolean): include OHLCV data.
• Wait for Chart Load (number): additional wait time in ms for chart to fully load.
Advanced Options Collection of advanced settings:
• Ignore HTTPS Errors (boolean): whether to ignore HTTPS errors.
• Timeout (number): page load timeout in milliseconds.
• User Agent (string): custom user agent string for the browser.

Output

The node outputs JSON objects containing the following fields:

  • success: boolean indicating if the operation succeeded.
  • symbol: the trading pair symbol used.
  • timeframe: the selected timeframe.
  • theme: chart theme.
  • layout: chart layout identifier.
  • study: applied study identifier.
  • market: market type.
  • botMode: whether bot mode was enabled.
  • chartUrl: the full TradingView URL loaded.
  • dimensions: object with width and height of the chart image.
  • chartImage: base64-encoded PNG image data URI of the rendered chart.
  • timestamp: ISO timestamp of when the chart was generated.
  • metadata: internal metadata including browser endpoint, TradingView endpoint, user agent, timeout, and HTTPS error handling flag.

Optional fields depending on output options:

  • base64Data: raw base64 string of the chart image (without data URI prefix).
  • indicators: extracted technical indicators data from the chart.
  • ohlcv: OHLCV data extracted from the chart.
  • studyCustomData: custom data extracted from the applied study.

If the node fails and "Continue On Fail" is enabled, it outputs an object with:

  • success: false
  • error: error message string
  • timestamp: failure timestamp

The node does not output binary data directly but includes the chart image as a base64-encoded string.

Dependencies

  • Requires a remote browser instance accessible via a WebSocket endpoint (e.g., a Puppeteer-controlled Chromium).
  • Access to the TradingView website or a compatible chart endpoint.
  • No internal API keys or credentials are required, but network access to TradingView and the remote browser must be configured.
  • The node uses Puppeteer library for browser automation.

Troubleshooting

  • Missing or invalid Browser WebSocket Endpoint: The node throws an error if the WebSocket endpoint is not provided or unreachable. Ensure the remote browser is running and accessible.
  • TradingView endpoint unreachable or changed: If the TradingView URL is incorrect or the site structure changes, the node may fail to load or extract data. Verify the endpoint URL and consider updating the node if TradingView updates their site.
  • Timeouts during page load: If the page takes too long to load, increase the "Timeout" or "Wait for Chart Load" properties.
  • Extraction failures for indicators, OHLCV, or study data: These are caught and logged as warnings; the node continues but without that data. This can happen if TradingView changes internal JavaScript functions or if the chart does not contain requested data.
  • HTTPS errors: If the remote browser encounters HTTPS errors, enable "Ignore HTTPS Errors" to bypass them.
  • Large image sizes: Setting very large width/height values may cause performance issues or failures. Use reasonable dimensions within allowed ranges.

Links and References

Discussion