đ Get real-time stocks from TradingView
TradingView-API
Construisez avec les données de marché, de votre premier graphique à une veille automatisée. Récupérez des bougies et des cotations, exécutez des indicateurs et des stratégies, et transformez vos idées en outils. Projet communautaire indépendant, pas une API officielle de TradingView.
DĂ©marrer · Explorer les exemples · Lire le guide de lâAPI de donnĂ©es
Langue : English · Français · Español · PortuguĂȘs
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 · CrĂ©er mon agent IA â
Une requĂȘte, de vraies donnĂ©es
La V4 est la version npm par défaut. Installez-la avec
npm install @mathieuc/tradingviewpour utilisergetCandleset la nouvelle API de données.
import { getCandles } from '@mathieuc/tradingview/data';
const candles = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', count: 40 });
console.log(candles.at(-1)); // { time, open, high, low, close, volume }

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. Toutes les fonctionnalitĂ©s V3 restent disponibles : voir la matrice de couverture et les preuves de fiabilitĂ©. Le rapport de prĂ©paration de la RC 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. Ces guides techniques sont en anglais.
Démarrer
Quick-start interactif
Le lanceur interactif est inclus dans la V4 :
npx @mathieuc/tradingview
Lancez-le depuis le dossier de votre projet avec Node.js 20+. Choisissez un parcours :
- Agent autonome (recommandĂ©) â ouvre la veille de marchĂ© TradingView-API sur Molted Studio. Aucune configuration de projet local.
- Claude Code CLI â dĂ©marre votre CLI
claudeinstallĂ© dans ce dossier, avec un prompt de projet prĂȘt Ă lâemploi. - Codex CLI â dĂ©marre votre CLI
codexinstallĂ© dans ce dossier, avec le mĂȘme prompt. - Un autre coding-agent local â affiche le prompt Ă coller dans votre agent.
- Installer seulement la librairie â exĂ©cute
npm install @mathieuc/tradingviewdans ce dossier, sans gĂ©nĂ©rer de fichiers ni dĂ©marrer dâagent.
Claude Code et Codex doivent dĂ©jĂ ĂȘtre installĂ©s et authentifiĂ©s. Leurs demandes dâautorisation habituelles restent actives. Si le lancement Ă©choue, le prompt est affichĂ© pour une utilisation manuelle. Si aucun navigateur nâest disponible, le lien hĂ©bergĂ© reste visible.
Utilisez --choice 4 pour afficher directement le prompt, ou --help pour lâaide. En mode non interactif, --choice est obligatoire. Pour essayer le lanceur depuis ce dĂ©pĂŽt :
npm ci && npm run build
node bin/tradingview.mjs
Installation manuelle
npm install @mathieuc/tradingview
# Ou : bun add @mathieuc/tradingview
La V4 est installée par défaut. La V3 reste disponible avec @mathieuc/tradingview@3 ; consultez le guide de migration avant de mettre à jour un projet V3.
Le paquet V4 est ESM avec des déclarations TypeScript. Les projets CommonJS peuvent utiliser require() avec Node 20.19+ ou 22.12+, ou await import().
Envie de contribuer ?
Ouvrez une issue pour discuter dâune fonctionnalitĂ© ou signaler un bug, ou proposez une pull request. Questions et idĂ©es sont bienvenues ; une reproduction parfaite nâest pas nĂ©cessaire pour engager la discussion. npm run check lance la vĂ©rification des types, le lint, les tests, la compilation et le test du paquet.
API de données
LâAPI de donnĂ©es gĂšre les connexions, les sessions, les dĂ©lais et le nettoyage Ă votre place. Elle convient aux scripts, serveurs, tableaux de bord, bots et agents.
import {
getCandles, watchCandles, getQuote, getIndicatorData, searchMarkets,
} from '@mathieuc/tradingview/data';
// One-shot: resolves with complete data, then releases everything.
const hourly = await getCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: '60', count: 500 });
const lastWeek = await getCandles({ symbol: 'NASDAQ:AAPL', timeframe: '15', from: new Date(Date.now() - 7 * 86_400_000) });
const quote = await getQuote('BINANCE:BTCUSDT');
const [market] = await searchMarkets('ethereum', { type: 'crypto' });
// Watcher: keeps streaming until stopped.
const watcher = await watchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: '1' }, {
onData: (candles) => console.log(candles.at(-1)?.close),
onError: (error) => console.error(error.code, error.message),
});
await watcher.stop();
// Indicators and strategies (Pine scripts need an account).
const { values } = await getIndicatorData({
symbol: 'BINANCE:BTCUSDT', indicator: 'STD;RSI', credentials: { session, signature },
});
| Besoin | Fonction |
|---|---|
| Bougies : derniĂšres barres, historique profond, plages de dates, Heikin Ashi/Renko/... | getCandles, watchCandles |
| Cotations : dernier prix, variation, bid/ask, volume... | getQuote, getQuotes, watchQuotes |
| Valeurs dâindicateurs, dessins et rapports de stratĂ©gie | getIndicatorData, watchIndicator |
| Métadonnées des symboles | getSymbolInfo |
| Screener actions/crypto et classements | getScreener, getHotlist |
| Listes de suivi du compte (lecture seule) | getWatchlists |
| Recherche et évaluations | searchMarkets, searchIndicators, getTechnicalAnalysis |
Les fonctions de donnĂ©es WebSocket acceptent timeoutMs, un AbortSignal, les identifiants du compte (credentials) et un client partagĂ© facultatif. Les requĂȘtes HTTP acceptent un AbortSignal via leurs options. Les erreurs sont des TradingViewError avec un code comme SYMBOL_ERROR, TIMEOUT ou STUDY_ERROR. Le guide de lâAPI de donnĂ©es dĂ©taille toutes les options.
API de backtest
Ăcrivez la rĂšgle dâentrĂ©e ; @mathieuc/tradingview/backtest fait le reste : bougies figĂ©es, rejet de lâanticipation (look-ahead), entrĂ©e Ă lâouverture suivante, frais et slippage aux deux bouts, exĂ©cutions pessimistes, sĂ©paration in-sample/out-of-sample, quatre sorties et une rĂ©fĂ©rence dâentrĂ©es alĂ©atoires seedĂ©es.
import { backtest, formatReport, rsiDivergence } from '@mathieuc/tradingview/backtest';
const { report } = await backtest({
symbol: 'BINANCE:BTCUSDT', timeframe: '240', years: 2,
signal: rsiDivergence(), // Ou la vĂŽtre : (candles) => [{ bar, direction: 'long' | 'short' }]
});
console.log(formatReport(report)); // report est du JSON simple : lignes par sortie et segment, trades, avertissements
Il ne promet aucune rentabilité : un résultat négatif ou non concluant est un résultat valable. Lire le guide du backtest (en anglais).
API bas niveau
Pour un contrÎle complet (plusieurs graphiques et études sur une connexion, mode replay, paquets bruts), utilisez directement le client et les sessions :
import { TradingViewClient, getIndicator } from '@mathieuc/tradingview';
const client = new TradingViewClient({ credentials: { session, signature } }); // Credentials are optional
const chart = client.createChart();
chart.on('update', () => console.log(chart.lastCandle?.close));
chart.on('error', (error) => console.error(error.message));
chart.setMarket('BINANCE:BTCUSDT', { timeframe: '60', count: 300 });
const supertrend = chart.createStudy(await getIndicator('STD;Supertrend'));
supertrend.on('update', () => console.log(supertrend.values.at(-1)));
// When your application is finished:
await client.close();
La rĂ©fĂ©rence de lâAPI bas niveau couvre les graphiques, le replay, les Ă©tudes, les cotations, les comptes et les mises en page, les permissions Pine, les transports personnalisĂ©s et les outils du protocole. Les exemples illustrent chaque fonctionnalitĂ©.
Comptes et limites
Sans compte, TradingView fournit des donnĂ©es limitĂ©es : historique intraday rĂ©duit, pas dâĂ©tudes Pine et flux Ă©ventuellement diffĂ©rĂ©s ou de substitution. Avec vos cookies sessionid et sessionid_sign (credentials), vous accĂ©dez Ă ce que permet votre compte. Gardez-les dans des variables dâenvironnement ou un gestionnaire de secrets ; jamais dans les fichiers source, les issues ou les prompts.
Liens du projet
- DépÎt GitHub
- Mise en avant communautaire sur Trendshift
- Paquet npm
- Exemples
- Signaler un bug ou proposer une fonctionnalité
TradingView est une marque de son propriĂ©taire. Ce projet nâest ni affiliĂ© Ă TradingView ni approuvĂ© par TradingView. VĂ©rifiez les conditions de votre fournisseur de donnĂ©es et les autorisations applicables Ă votre usage.
