@mathieuc/tradingview 3.0.1 → 3.2.0

package/README.md

@@ -1,4 +1,11 @@
-# TradingView API
+# TradingView API [![Open in Visual Studio Code](https://open.vscode.dev/badges/open-in-vscode.svg)](https://open.vscode.dev/Mathieu2301/TradingView-API) [![GitHub stars](https://img.shields.io/github/stars/Mathieu2301/TradingView-API.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/Mathieu2301/TradingView-API/stargazers/)
+
+[![Tests](https://github.com/Mathieu2301/TradingView-API/actions/workflows/node.js.yml/badge.svg)](https://github.com/Mathieu2301/TradingView-API/actions/workflows/node.js.yml)
+[![Minimum node.js version](https://badgen.net/npm/node/@mathieuc/tradingview)](https://npmjs.com/@mathieuc/tradingview)
+[![Npm package yearly downloads](https://badgen.net/npm/dt/@mathieuc/tradingview)](https://npmjs.com/@mathieuc/tradingview)
+[![GitHub latest commit](https://img.shields.io/github/last-commit/Mathieu2301/TradingView-API)](https://GitHub.com/Mathieu2301/TradingView-API/commit/)
+[![Npm package version](https://badgen.net/npm/v/@mathieuc/tradingview)](https://npmjs.com/package/@mathieuc/tradingview)
+
 Get realtime market prices and indicator values from Tradingview !
 
 ## Features
@@ -9,6 +16,7 @@ Get realtime market prices and indicator values from Tradingview !
 - [x] Unlimited simultaneous indicators
 - [x] Realtime
 - [x] Get TradingView's technical analysis
+- [x] Replay mode + Fake Replay mode (for free plan)
 - [x] Get values from a specific date range
 - [ ] TradingView socket server emulation
 - [ ] Interract with public chats
@@ -27,9 +35,14 @@ Get realtime market prices and indicator values from Tradingview !
 ___
 ## Installation
 
-```
+Stable version:
+```ruby
 npm i @mathieuc/tradingview
 ```
+Last version:
+```ruby
+npm i github:Mathieu2301/TradingView-API
+```
 
 ## Examples
 You can find all the examples and snippets in `./examples` folder.

package/examples/AllPrivateIndicators.js

@@ -5,10 +5,10 @@ const TradingView = require('../main');
   all user's private indicators
 */
 
+if (!process.argv[2]) throw Error('Please specify your \'sessionid\' cookie');
+
 const client = new TradingView.Client({
-  /* Token is only needed if at least one indicator is
-    PRIVATE (if you have a paid TradingView account) */
-  token: 'YOUR_SESSION_ID_COOKIE',
+  token: process.argv[2],
 });
 
 const chart = new client.Session.Chart();
@@ -16,7 +16,7 @@ chart.setMarket('BINANCE:BTCEUR', {
   timeframe: 'D',
 });
 
-TradingView.getPrivateIndicators('YOUR_SESSION_ID_COOKIE').then((indicList) => {
+TradingView.getPrivateIndicators(process.argv[2]).then((indicList) => {
   indicList.forEach(async (indic) => {
     const privateIndic = await indic.get();
     console.log('Loading indicator', indic.name, '...');

package/examples/CustomChartType.js

@@ -17,6 +17,7 @@ const chart = new client.Session.Chart();
 
 chart.onError((...err) => {
   console.log('Chart error:', ...err);
+  process.exit(1);
 });
 
 chart.onUpdate(() => {

package/examples/Errors.js

@@ -1,153 +1,147 @@
-const TradingView = require('../main');
-
-/*
-  This example tests many types of errors
-*/
-
-const client = new TradingView.Client(); // Creates a websocket client
-
-const tests = [
-  (next) => { /* Testing "Credentials error" */
-    console.info('\nTesting "Credentials error" error:');
-
-    const client2 = new TradingView.Client({
-      token: 'FAKE_CREDENTIALS', // Set wrong credentials
-    });
-
-    client2.onError((...err) => {
-      console.error(' => Client error:', err);
-      client2.end();
-      next();
-    });
-  },
-
-  (next) => { /* Testing "Invalid symbol" */
-    console.info('\nTesting "Invalid symbol" error:');
-
-    const chart = new client.Session.Chart();
-    chart.onError((...err) => { // Listen for errors
-      console.error(' => Chart error:', err);
-      chart.delete();
-      next();
-    });
-
-    chart.setMarket('XXXXX'); // Set a wrong market
-  },
-
-  (next) => { /* Testing "Invalid timezone" */
-    console.info('\nTesting "Invalid timezone" error:');
-
-    const chart = new client.Session.Chart();
-    chart.onError((...err) => { // Listen for errors
-      console.error(' => Chart error:', err);
-      next();
-    });
-
-    chart.setMarket('BINANCE:BTCEUR'); // Set a market
-    chart.setTimezone('Nowhere/Nowhere'); // Set a fake timezone
-  },
-
-  (next) => { /* Testing "Custom timeframe" */
-    console.info('\nTesting "Custom timeframe" error:');
-
-    const chart = new client.Session.Chart();
-    chart.onError((...err) => { // Listen for errors
-      console.error(' => Chart error:', err);
-      chart.delete();
-      next();
-    });
-
-    chart.setMarket('BINANCE:BTCEUR', { // Set a market
-      timeframe: '20', // Set a custom timeframe
-      /*
-        Timeframe '20' isn't available because we are
-        not logged in as a premium TradingView user
-      */
-    });
-  },
-
-  (next) => { /* Testing "Invalid timeframe" */
-    console.info('\nTesting "Invalid timeframe" error:');
-
-    const chart = new client.Session.Chart();
-    chart.onError((...err) => { // Listen for errors
-      console.error(' => Chart error:', err);
-      next();
-    });
-
-    chart.setMarket('BINANCE:BTCEUR', { // Set a market
-      timeframe: 'XX', // Set a wrong timeframe
-    });
-  },
-
-  (next) => { /* Testing "Study not auth" */
-    console.info('\nTesting "Study not auth" error:');
-
-    const chart = new client.Session.Chart();
-    chart.onError((...err) => { // Listen for errors
-      console.error(' => Chart error:', err);
-      next();
-    });
-
-    chart.setMarket('BINANCE:BTCEUR', { // Set a market
-      timeframe: '15',
-      type: 'Renko',
-    });
-
-    chart.onUpdate(() => {
-      console.log('DATA', chart.periods[0]);
-    });
-  },
-
-  (next) => { /* Testing "Set the market before" */
-    console.info('\nTesting "Set the market before..." error:');
-
-    const chart = new client.Session.Chart();
-    chart.onError((...err) => { // Listen for errors
-      console.error(' => Chart error:', err);
-      chart.delete();
-      next();
-    });
-
-    chart.setSeries('15'); // Set series before setting the market
-  },
-
-  (next) => { /* Testing "Inexistent indicator" */
-    console.info('\nTesting "Inexistent indicator" error:');
-
-    TradingView.getIndicator('STD;XXXXXXX')
-      .catch((err) => {
-        console.error(' => API error:', [err.message]);
-        next();
-      });
-  },
-
-  async (next) => { /* Testing "Invalid value" */
-    console.info('\nTesting "Invalid value" error:');
-
-    const chart = new client.Session.Chart();
-    chart.setMarket('BINANCE:BTCEUR'); // Set a market
-
-    const ST = await TradingView.getIndicator('STD;Supertrend');
-    ST.setOption('Factor', -1); // This will cause an error
-
-    const Supertrend = new chart.Study(ST);
-    Supertrend.onError((...err) => {
-      console.error(' => Study error:', err);
-      chart.delete();
-      next();
-    });
-  },
-];
-
-let i = 0;
-const execTest = () => {
-  if (tests[i + 1]) {
-    tests[(i += 1) - 1](execTest);
-  } else {
-    tests[(i += 1) - 1](() => {
-      console.log(`\nTests ${i}/${i} done !`);
-    });
-  }
-};
-execTest();
+const TradingView = require('../main');
+
+/*
+  This example tests many types of errors
+*/
+
+const client = new TradingView.Client(); // Creates a websocket client
+
+const tests = [
+  (next) => { /* Testing "Credentials error" */
+    console.info('\nTesting "Credentials error" error:');
+
+    const client2 = new TradingView.Client({
+      token: 'FAKE_CREDENTIALS', // Set wrong credentials
+    });
+
+    client2.onError((...err) => {
+      console.error(' => Client error:', err);
+      client2.end();
+      next();
+    });
+  },
+
+  (next) => { /* Testing "Invalid symbol" */
+    console.info('\nTesting "Invalid symbol" error:');
+
+    const chart = new client.Session.Chart();
+    chart.onError((...err) => { // Listen for errors
+      console.error(' => Chart error:', err);
+      chart.delete();
+      next();
+    });
+
+    chart.setMarket('XXXXX'); // Set a wrong market
+  },
+
+  (next) => { /* Testing "Invalid timezone" */
+    console.info('\nTesting "Invalid timezone" error:');
+
+    const chart = new client.Session.Chart();
+    chart.onError((...err) => { // Listen for errors
+      console.error(' => Chart error:', err);
+      next();
+    });
+
+    chart.setMarket('BINANCE:BTCEUR'); // Set a market
+    chart.setTimezone('Nowhere/Nowhere'); // Set a fake timezone
+  },
+
+  (next) => { /* Testing "Custom timeframe" */
+    console.info('\nTesting "Custom timeframe" error:');
+
+    const chart = new client.Session.Chart();
+    chart.onError((...err) => { // Listen for errors
+      console.error(' => Chart error:', err);
+      chart.delete();
+      next();
+    });
+
+    chart.setMarket('BINANCE:BTCEUR', { // Set a market
+      timeframe: '20', // Set a custom timeframe
+      /*
+        Timeframe '20' isn't available because we are
+        not logged in as a premium TradingView account
+      */
+    });
+  },
+
+  (next) => { /* Testing "Invalid timeframe" */
+    console.info('\nTesting "Invalid timeframe" error:');
+
+    const chart = new client.Session.Chart();
+    chart.onError((...err) => { // Listen for errors
+      console.error(' => Chart error:', err);
+      next();
+    });
+
+    chart.setMarket('BINANCE:BTCEUR', { // Set a market
+      timeframe: 'XX', // Set a wrong timeframe
+    });
+  },
+
+  (next) => { /* Testing "Study not auth" */
+    console.info('\nTesting "Study not auth" error:');
+
+    const chart = new client.Session.Chart();
+    chart.onError((...err) => { // Listen for errors
+      console.error(' => Chart error:', err);
+      next();
+    });
+
+    chart.setMarket('BINANCE:BTCEUR', { // Set a market
+      timeframe: '15',
+      type: 'Renko',
+    });
+
+    chart.onUpdate(() => {
+      console.log('DATA', chart.periods[0]);
+    });
+  },
+
+  (next) => { /* Testing "Set the market before" */
+    console.info('\nTesting "Set the market before..." error:');
+
+    const chart = new client.Session.Chart();
+    chart.onError((...err) => { // Listen for errors
+      console.error(' => Chart error:', err);
+      chart.delete();
+      next();
+    });
+
+    chart.setSeries('15'); // Set series before setting the market
+  },
+
+  (next) => { /* Testing "Inexistent indicator" */
+    console.info('\nTesting "Inexistent indicator" error:');
+
+    TradingView.getIndicator('STD;XXXXXXX')
+      .catch((err) => {
+        console.error(' => API error:', [err.message]);
+        next();
+      });
+  },
+
+  async (next) => { /* Testing "Invalid value" */
+    console.info('\nTesting "Invalid value" error:');
+
+    const chart = new client.Session.Chart();
+    chart.setMarket('BINANCE:BTCEUR'); // Set a market
+
+    const ST = await TradingView.getIndicator('STD;Supertrend');
+    ST.setOption('Factor', -1); // This will cause an error
+
+    const Supertrend = new chart.Study(ST);
+    Supertrend.onError((...err) => {
+      console.error(' => Study error:', err);
+      chart.delete();
+      next();
+    });
+  },
+];
+
+(async () => {
+  // eslint-disable-next-line no-restricted-syntax, no-await-in-loop
+  for (const t of tests) await new Promise(t);
+  console.log(`\nTests ${tests.length}/${tests.length} done !`);
+})();

package/examples/FakeReplayMode.js

@@ -0,0 +1,41 @@
+const { Client } = require('../main');
+
+/*
+  This example tests the fake
+  replay mode which works in
+  intraday even with free plan
+*/
+
+console.log('----- Testing FakeReplayMode: -----');
+
+const client = new Client();
+const chart = new client.Session.Chart();
+
+chart.setMarket('BINANCE:BTCEUR', {
+  timeframe: 'D',
+  range: -1, // Range is negative, so 'to' means 'from'
+  to: Math.round(Date.now() / 1000) - 86400 * 7, // Seven days before now
+  // to: 1600000000,
+});
+
+let interval = NaN;
+
+chart.onUpdate(async () => {
+  const times = chart.periods.map((p) => p.time);
+
+  const intrval = times[0] - times[1];
+  if (Number.isNaN(interval) && times.length >= 2) interval = intrval;
+
+  if (!Number.isNaN(interval) && interval !== intrval) {
+    throw new Error(`Wrong interval: ${intrval} (should be ${interval})`);
+  }
+
+  console.log('Next ->', times[0]);
+
+  if ((times[0] + 86400) * 1000 > Date.now()) {
+    await client.end();
+    console.log('Done !', times.length);
+  }
+
+  chart.fetchMore(-1);
+});

package/examples/PinePermManage.js

@@ -0,0 +1,57 @@
+const { PinePermManager } = require('../main');
+
+/*
+  This example creates a pine
+  permission manager and tests
+  all the available functions
+*/
+
+const sessionid = process.argv[2];
+const pineid = process.argv[3];
+
+const manager = new PinePermManager(sessionid, pineid);
+
+(async () => {
+  console.log('Users:', await manager.getUsers());
+
+  console.log('Adding user \'TradingView\'...');
+
+  switch (await manager.addUser('TradingView')) {
+    case 'ok':
+      console.log('Done !');
+      break;
+    case 'exists':
+      console.log('This user is already authorized');
+      break;
+    default:
+      console.error('Unknown error...');
+      break;
+  }
+
+  console.log('Users:', await manager.getUsers());
+
+  console.log('Modifying expiration date...');
+
+  const newDate = new Date(Date.now() + 24 * 3600000); // Add one day
+  if (await manager.modifyExpiration('TradingView', newDate) === 'ok') {
+    console.log('Done !');
+  } else console.error('Unknown error...');
+
+  console.log('Users:', await manager.getUsers());
+
+  console.log('Removing expiration date...');
+
+  if (await manager.modifyExpiration('TradingView') === 'ok') {
+    console.log('Done !');
+  } else console.error('Unknown error...');
+
+  console.log('Users:', await manager.getUsers());
+
+  console.log('Removing user \'TradingView\'...');
+
+  if (await manager.removeUser('TradingView') === 'ok') {
+    console.log('Done !');
+  } else console.error('Unknown error...');
+
+  console.log('Users:', await manager.getUsers());
+})();

package/examples/ReplayMode.js

@@ -0,0 +1,97 @@
+const TradingView = require('../main');
+
+/*
+  This example tests the real replay
+  mode by fetching indicator data and
+  stores it in a 'periods' variable
+*/
+
+const config = {
+  symbol: 'BINANCE:BTCEUR',
+  timeframe: 'D',
+  startFrom: Math.round(Date.now() / 1000) - 86400 * 7, // Seven days before now
+  // startFrom: 1600000000,
+};
+
+console.log('----- Testing ReplayMode: -----');
+
+const client = new TradingView.Client();
+const chart = new client.Session.Chart();
+
+chart.setMarket(config.symbol, {
+  timeframe: config.timeframe,
+  replay: config.startFrom,
+  range: 1,
+});
+
+// chart.onReplayLoaded(() => {
+//   console.log('STARTING REPLAY MODE');
+//   chart.replayStart(1000);
+
+//   // setTimeout(() => {
+//   //   console.log('STOPPING REPLAY MODE');
+//   //   chart.replayStop();
+//   // }, 7000);
+// });
+
+let loading = 0;
+const indicators = [];
+const periods = {};
+
+let interval = NaN;
+
+async function step() {
+  const period = { ...chart.periods[0] };
+
+  const times = Object.keys(periods);
+  const intrval = times[times.length - 1] - times[times.length - 2];
+  if (Number.isNaN(interval) && times.length >= 2) interval = intrval;
+
+  if (!Number.isNaN(interval) && interval !== intrval) {
+    throw new Error(`Wrong interval: ${intrval} (should be ${interval})`);
+  }
+
+  indicators.forEach(([n, i]) => {
+    const plots = { ...i.periods[0] };
+    delete plots.$time;
+    period[n] = { plots };
+
+    Object.keys(i.graphic).forEach((g) => {
+      if (!i.graphic[g].length) return;
+      if (!period[n].graphics) period[n].graphics = {};
+      period[n].graphics[g] = i.graphic[g];
+    });
+  });
+
+  periods[period.time] = period;
+
+  console.log('Next ->', period.time, times.length);
+
+  await chart.replayStep(1);
+  step();
+}
+
+chart.onReplayEnd(async () => {
+  await client.end();
+  console.log('Done !', Object.keys(periods).length);
+});
+
+async function addIndicator(name, pineId, options = {}) {
+  loading += 1;
+
+  const indic = pineId.includes('@')
+    ? new TradingView.BuiltInIndicator(pineId)
+    : await TradingView.getIndicator(pineId);
+  Object.keys(options).forEach((o) => { indic.setOption(o, options[o]); });
+
+  const std = new chart.Study(indic);
+
+  std.onReady(() => {
+    indicators.push([name, std]);
+    if (loading === indicators.length) step();
+  });
+}
+
+addIndicator('Volume', 'Volume@tv-basicstudies-144');
+addIndicator('EMA_50', 'STD;EMA', { Length: 50 });
+addIndicator('EMA_200', 'STD;EMA', { Length: 200 });

package/main.js

@@ -2,8 +2,10 @@ const miscRequests = require('./src/miscRequests');
 const Client = require('./src/client');
 const BuiltInIndicator = require('./src/classes/BuiltInIndicator');
 const PineIndicator = require('./src/classes/PineIndicator');
+const PinePermManager = require('./src/classes/PinePermManager');
 
 module.exports = { ...miscRequests };
 module.exports.Client = Client;
 module.exports.BuiltInIndicator = BuiltInIndicator;
 module.exports.PineIndicator = PineIndicator;
+module.exports.PinePermManager = PinePermManager;

package/package.json

@@ -1,20 +1,18 @@
 {
   "name": "@mathieuc/tradingview",
-  "version": "3.0.1",
+  "version": "3.2.0",
   "description": "Tradingview instant stocks API, indicator alerts, trading bot, and more !",
   "main": "main.js",
   "scripts": {
-    "test-prices": "node ./tests/prices.js",
-    "test-analysis": "node ./tests/analysis.js",
-    "test-indicator": "node ./tests/indicator.js",
-    "test-manual-alerts": "node ./tests/alerts/manualAlert.js",
-    "test-strat-alerts": "node ./tests/alerts/strategyAlert.js",
-    "test": "npm run test-prices"
+    "test": "node test"
   },
   "repository": {
     "type": "git",
     "url": "git+https://github.com/Mathieu2301/TradingView-API.git"
   },
+  "engines": {
+    "node": ">=14.0.0"
+  },
   "keywords": [
     "tradingwiew",
     "market",

package/src/FormData.js

@@ -0,0 +1,35 @@
+class FormData {
+  #string = '';
+
+  #boundary = '';
+
+  get boundary() {
+    return this.#boundary;
+  }
+
+  constructor() {
+    const random = (Math.random() * 10 ** 20).toString(36);
+    this.#boundary = `${random}`;
+    this.#string = `--${this.boundary}`;
+  }
+
+  /**
+   * Adds a property to the FormData object
+   * @param {string} key Property key
+   * @param {string} value Property value
+   */
+  append(key, value) {
+    this.#string += `\r\nContent-Disposition: form-data; name="${key}"`;
+    this.#string += `\r\n\r\n${value}`;
+    this.#string += `\r\n--${this.boundary}`;
+  }
+
+  /**
+   * @returns {string}
+   */
+  toString() {
+    return `${this.#string}--`;
+  }
+}
+
+module.exports = FormData;