Skip to content

📈 Get real-time stocks from TradingView

11.3 KB
Raw Blame

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

Tests npm Stars

Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift

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

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/tradingview pour utiliser getCandles et 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 }

DĂ©monstration enregistrĂ©e : une requĂȘte renvoie 40 bougies quotidiennes BTC/USDT, reprĂ©sentĂ©es en courbe

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 :

  1. Agent autonome (recommandĂ©) — ouvre la veille de marchĂ© TradingView-API sur Molted Studio. 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.
  5. Installer seulement la librairie — exĂ©cute npm install @mathieuc/tradingview dans 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

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.