Skip to content

📈 Get real-time stocks from TradingView

Add the molted film to the README hero and point the launcher to the TradingView agent page

Mathieu Colmonddc8b81047d3
diff --git a/README.md b/README.md
index ecd06db..e680cf4 100644
--- a/README.md
+++ b/README.md
@@ -10,9 +10,11 @@
<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>
-![Recorded demonstration: a candle request returns 40 daily BTC/USDT candles, visualized as a line chart](assets/readme-demo.gif)
+<a href="https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api"><img src="assets/readme-film.webp" alt="Film: a trader asks an AI agent to turn a private TradingView indicator into a bot; the agent installs TradingView-API, backtests it and trades it on a demo account" width="100%"></a>
-*An actual candle request, recorded on 2 October 2026 with the development preview (`fetchCandles`, called `getCandles` in version 4) and visualized for this demo. Prices are not live.*
+**Turn your TradingView indicators into a trading bot, just by chatting.** An AI agent on molted installs TradingView-API, backtests your setup and runs it 24/7 on a demo account. Real money only when you say so.
+
+**[▶ Watch the film with sound](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api#film)** · **[Create my AI agent →](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api)**
### One request, real data
@@ -25,6 +27,10 @@ const candles = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', co
console.log(candles.at(-1)); // { time, open, high, low, close, volume }
```
+![Recorded demonstration: a candle request returns 40 daily BTC/USDT candles, visualized as a line chart](assets/readme-demo.gif)
+
+*An actual candle request, recorded on 2 October 2026 with the development preview (`fetchCandles`, called `getCandles` in version 4) and visualized for this demo. Prices are not live.*
+
Prefer to start without code? The setup paths below work too.
> **Version 4 is a breaking rewrite** in TypeScript, with a new API and no compatibility layer. Coming from v3? Read the [migration guide](docs/migration-v4.md). Every v3 feature is still available: see the [coverage matrix](docs/v4-coverage.md) and [reliability evidence](docs/v4-reliability.md). The [RC preparation report](docs/v4-stabilization.md) tracks current checks and remaining release gates. npm versions 3.x keep the previous `Client` API; check the [npm page](https://www.npmjs.com/package/@mathieuc/tradingview) for the version you install.
@@ -41,7 +47,7 @@ npx @mathieuc/tradingview
Run it from your project directory with Node.js 20+. Choose a path:
-1. **Autonomous agent (recommended)** — opens the [TradingView-API market watcher on Molted Studio](https://molted.studio/dreams/market-watch-alerts). No local project setup.
+1. **Autonomous agent (recommended)** — opens the [TradingView-API market watcher on Molted Studio](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api). No local project setup.
2. **Claude Code CLI** — starts your installed `claude` CLI here with a ready-to-use project prompt.
3. **Codex CLI** — starts your installed `codex` CLI here with the same prompt.
4. **Another local coding agent** — prints the prompt to paste into your agent.
diff --git a/assets/readme-film-fr.webp b/assets/readme-film-fr.webp
new file mode 100644
index 0000000..d246307
Binary files /dev/null and b/assets/readme-film-fr.webp differ
diff --git a/assets/readme-film.webp b/assets/readme-film.webp
new file mode 100644
index 0000000..baa8e83
Binary files /dev/null and b/assets/readme-film.webp differ
diff --git a/docs/README.es.md b/docs/README.es.md
index bcc5cf3..9e8d941 100644
--- a/docs/README.es.md
+++ b/docs/README.es.md
@@ -10,9 +10,11 @@
<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>
-![Demostración grabada: una consulta devuelve 40 velas diarias de BTC/USDT, representadas como un gráfico de líneas](../assets/readme-demo.gif)
+<a href="https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api"><img src="../assets/readme-film.webp" alt="Película: un trader pide a un agente de IA que convierta su indicador privado de TradingView en un bot; el agente instala TradingView-API, lo prueba con datos históricos y opera en una cuenta demo" width="100%"></a>
-*Una consulta real de velas, grabada el 2 de octubre de 2026 con la versión preliminar de desarrollo (`fetchCandles`, llamada `getCandles` en la versión 4) y representada para esta demostración. Los precios no son en directo.*
+**Convierte tus indicadores de TradingView en un bot de trading, solo conversando.** Un agente de IA en molted instala TradingView-API, prueba tu estrategia con datos históricos y la ejecuta 24/7 en una cuenta demo. Dinero real solo cuando tú lo decidas.
+
+**[▶ Ver la película con sonido](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api#film)** · **[Crear mi agente de IA →](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api)**
### Una consulta, datos reales
@@ -25,6 +27,10 @@ const candles = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', co
console.log(candles.at(-1)); // { time, open, high, low, close, volume }
```
+![Demostración grabada: una consulta devuelve 40 velas diarias de BTC/USDT, representadas como un gráfico de líneas](../assets/readme-demo.gif)
+
+*Una consulta real de velas, grabada el 2 de octubre de 2026 con la versión preliminar de desarrollo (`fetchCandles`, llamada `getCandles` en la versión 4) y representada para esta demostración. Los precios no son en directo.*
+
¿Prefieres empezar sin código? También puedes usar las opciones de abajo.
> **La versión 4 es una reescritura incompatible en TypeScript**, con una API nueva y sin capa de compatibilidad. ¿Vienes de V3? Lee la [guía de migración](migration-v4.md). Todas las funciones de V3 siguen disponibles: consulta la [matriz de cobertura](v4-coverage.md) y las [pruebas de fiabilidad](v4-reliability.md). El [informe de preparación de la RC](v4-stabilization.md) documenta las comprobaciones y los requisitos pendientes para la versión estable. Las versiones npm 3.x conservan la API `Client` anterior; comprueba la versión que instalas en la [página de npm](https://www.npmjs.com/package/@mathieuc/tradingview). Estas guías técnicas están en inglés.
@@ -41,7 +47,7 @@ npx @mathieuc/tradingview
Ejecútalo desde el directorio de tu proyecto con Node.js 20+. Elige una opción:
-1. **Agente autónomo (recomendado)** — abre el [monitor de mercado TradingView-API en Molted Studio](https://molted.studio/dreams/market-watch-alerts). Sin configurar un proyecto local.
+1. **Agente autónomo (recomendado)** — abre el [monitor de mercado TradingView-API en Molted Studio](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api). Sin configurar un proyecto local.
2. **Claude Code CLI** — inicia tu CLI `claude` instalado en este directorio con un prompt de proyecto listo para usar.
3. **Codex CLI** — inicia tu CLI `codex` instalado en este directorio con el mismo prompt.
4. **Otro agente de programación local** — muestra el prompt para pegarlo en tu agente.
diff --git a/docs/README.fr.md b/docs/README.fr.md
index f5711ba..06af4b9 100644
--- a/docs/README.fr.md
+++ b/docs/README.fr.md
@@ -10,9 +10,11 @@
<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>
-![Démonstration enregistrée : une requête renvoie 40 bougies quotidiennes BTC/USDT, représentées en courbe](../assets/readme-demo.gif)
+<a href="https://molted.studio/fr/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api"><img src="../assets/readme-film-fr.webp" alt="Film : un trader demande à un agent IA de transformer son indicateur TradingView privé en bot ; l’agent installe TradingView-API, le backteste et le fait trader sur un compte démo" width="100%"></a>
-*Une vraie requête de bougies, enregistrée le 2 octobre 2026 avec la préversion de développement (`fetchCandles`, appelée `getCandles` en version 4), puis représentée pour cette démonstration. Les prix ne sont pas en direct.*
+**Transformez vos indicateurs TradingView en bot de trading, simplement en discutant.** Un agent IA sur molted installe TradingView-API, backteste votre setup et le fait tourner 24 h/24 sur un compte démo. L’argent réel, seulement quand vous le décidez.
+
+**[▶ Voir le film avec le son](https://molted.studio/fr/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api#film)** · **[Créer mon agent IA →](https://molted.studio/fr/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api)**
### Une requête, de vraies données
@@ -25,6 +27,10 @@ const candles = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', co
console.log(candles.at(-1)); // { time, open, high, low, close, volume }
```
+![Démonstration enregistrée : une requête renvoie 40 bougies quotidiennes BTC/USDT, représentées en courbe](../assets/readme-demo.gif)
+
+*Une vraie requête de bougies, enregistrée le 2 octobre 2026 avec la préversion de développement (`fetchCandles`, appelée `getCandles` en version 4), puis représentée pour cette démonstration. Les prix ne sont pas en direct.*
+
Vous préférez commencer sans coder ? Les parcours ci-dessous le permettent aussi.
> **La version 4 est une réécriture incompatible en TypeScript**, avec une nouvelle API et sans couche de compatibilité. Vous venez de la V3 ? Lisez le [guide de migration](migration-v4.md). Toutes les fonctionnalités V3 restent disponibles : voir la [matrice de couverture](v4-coverage.md) et les [preuves de fiabilité](v4-reliability.md). Le [rapport de préparation de la RC](v4-stabilization.md) suit les vérifications et les conditions restantes avant publication stable. Les versions npm 3.x conservent l’ancienne API `Client` ; vérifiez la version installée sur la [page npm](https://www.npmjs.com/package/@mathieuc/tradingview). Ces guides techniques sont en anglais.
@@ -41,7 +47,7 @@ npx @mathieuc/tradingview
Lancez-le depuis le dossier de votre projet avec Node.js 20+. Choisissez un parcours :
-1. **Agent autonome (recommandé)** — ouvre la [veille de marché TradingView-API sur Molted Studio](https://molted.studio/fr/dreams/market-watch-alerts). Aucune configuration de projet local.
+1. **Agent autonome (recommandé)** — ouvre la [veille de marché TradingView-API sur Molted Studio](https://molted.studio/fr/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api). Aucune configuration de projet local.
2. **Claude Code CLI** — démarre votre CLI `claude` installé dans ce dossier, avec un prompt de projet prêt à l’emploi.
3. **Codex CLI** — démarre votre CLI `codex` installé dans ce dossier, avec le même prompt.
4. **Un autre coding-agent local** — affiche le prompt à coller dans votre agent.
diff --git a/docs/README.pt.md b/docs/README.pt.md
index e28660f..eae4ac6 100644
--- a/docs/README.pt.md
+++ b/docs/README.pt.md
@@ -10,9 +10,11 @@
<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&amp;utm_medium=badge&amp;utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>
-![Demonstração gravada: uma consulta retorna 40 candles diários de BTC/USDT, exibidos em um gráfico de linhas](../assets/readme-demo.gif)
+<a href="https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api"><img src="../assets/readme-film.webp" alt="Filme: um trader pede a um agente de IA que transforme seu indicador privado do TradingView em um bot; o agente instala a TradingView-API, faz o backtest e opera em uma conta demo" width="100%"></a>
-*Uma consulta real de candles, gravada em 2 de outubro de 2026 com a prévia de desenvolvimento (`fetchCandles`, chamada `getCandles` na versão 4) e representada para esta demonstração. Os preços não estão em tempo real.*
+**Transforme seus indicadores do TradingView em um bot de trading, só conversando.** Um agente de IA na molted instala a TradingView-API, faz o backtest da sua estratégia e a executa 24/7 em uma conta demo. Dinheiro real só quando você decidir.
+
+**[▶ Ver o filme com som](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api#film)** · **[Criar meu agente de IA →](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api)**
### Uma consulta, dados reais
@@ -25,6 +27,10 @@ const candles = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', co
console.log(candles.at(-1)); // { time, open, high, low, close, volume }
```
+![Demonstração gravada: uma consulta retorna 40 candles diários de BTC/USDT, exibidos em um gráfico de linhas](../assets/readme-demo.gif)
+
+*Uma consulta real de candles, gravada em 2 de outubro de 2026 com a prévia de desenvolvimento (`fetchCandles`, chamada `getCandles` na versão 4) e representada para esta demonstração. Os preços não estão em tempo real.*
+
Prefere começar sem código? Os caminhos abaixo também funcionam.
> **A versão 4 é uma reescrita incompatível em TypeScript**, com uma nova API e sem camada de compatibilidade. Vem da V3? Leia o [guia de migração](migration-v4.md). Todas as funcionalidades da V3 continuam disponíveis: veja a [matriz de cobertura](v4-coverage.md) e as [evidências de confiabilidade](v4-reliability.md). O [relatório de preparação da RC](v4-stabilization.md) acompanha as verificações e os requisitos pendentes para a versão estável. As versões npm 3.x mantêm a API `Client` anterior; confira a versão instalada na [página do npm](https://www.npmjs.com/package/@mathieuc/tradingview). Esses guias técnicos estão em inglês.
@@ -41,7 +47,7 @@ npx @mathieuc/tradingview
Execute no diretório do seu projeto com Node.js 20+. Escolha um caminho:
-1. **Agente autônomo (recomendado)** — abre o [monitor de mercado TradingView-API no Molted Studio](https://molted.studio/dreams/market-watch-alerts). Sem configurar um projeto local.
+1. **Agente autônomo (recomendado)** — abre o [monitor de mercado TradingView-API no Molted Studio](https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=readme&utm_campaign=tradingview-api). Sem configurar um projeto local.
2. **Claude Code CLI** — inicia seu CLI `claude` instalado neste diretório com um prompt de projeto pronto para usar.
3. **Codex CLI** — inicia seu CLI `codex` instalado neste diretório com o mesmo prompt.
4. **Outro agente de programação local** — exibe o prompt para colar no seu agente.
diff --git a/src/quick-start.ts b/src/quick-start.ts
index afe0fe4..dc90b7e 100644
--- a/src/quick-start.ts
+++ b/src/quick-start.ts
@@ -1,7 +1,7 @@
import { spawnSync, type SpawnSyncOptions, type SpawnSyncReturns } from 'node:child_process';
import { createInterface } from 'node:readline/promises';
-export const LANDING_URL = 'https://molted.studio/dreams/market-watch-alerts';
+export const LANDING_URL = 'https://molted.studio/dreams/ai-agent-for-tradingview-data?utm_source=github&utm_medium=cli&utm_campaign=tradingview-api';
export const PACKAGE_SPEC = '@mathieuc/tradingview';
export const AGENT_PROMPT = `Help me build a project using TradingView-API V4 (${PACKAGE_SPEC}).
First ask what I want to build and inspect the current project and its instructions before making changes.