metaapi.cloud-sdk/examples/node/historical/getCandles.js

SDK for MetaApi, a professional cloud forex API which includes MetaTrader REST API and MetaTrader websocket API. Supports both MetaTrader 5 (MT5) and MetaTrader 4 (MT4). CopyFactory copy trading API included. (https://metaapi.cloud)

const MetaApi = require('metaapi.cloud-sdk').default;

const accountId = process.env.ACCOUNT_ID || '<put in your account id here>';
const token = process.env.TOKEN || '<put in your token here>';

const domain = process.env.DOMAIN || 'agiliumtrade.agiliumtrade.ai';
const symbol = process.env.SYMBOL || 'EURUSD';

const api = new MetaApi(token, {domain});

// eslint-disable-next-line
async function retrieveHistoricalCandles() {
  try {
    let account = await api.metatraderAccountApi.getAccount(accountId);

    // wait until account is deployed and connected to broker
    console.log('Deploying account');
    if (account.state !== 'DEPLOYED') {
      await account.deploy();
    } else {
      console.log('Account already deployed');
    }
    console.log('Waiting for API server to connect to broker (may take couple of minutes)');
    if (account.connectionStatus !== 'CONNECTED') {
      await account.waitConnected();
    }

    // retrieve last 10K 1m candles
    let pages = 10;
    console.log(`Downloading ${pages}K latest candles for ${symbol}`);
    let startedAt = Date.now();
    let startTime;
    let candles;
    for (let i = 0; i < pages; i++) {
      // the API to retrieve historical market data is currently available for G1 and MT4 G2 only
      let newCandles = await account.getHistoricalCandles(symbol, '1m', startTime);
      console.log(`Downloaded ${newCandles ? newCandles.length : 0} historical candles for ${symbol}`);
      if (newCandles && newCandles.length) {
        candles = newCandles;
      }
      if (candles && candles.length) {
        startTime = candles[0].time;
        startTime.setMinutes(startTime.getMinutes() - 1);
        console.log(`First candle time is ${startTime}`);
      }
    }
    if (candles) {
      console.log('First candle is', candles[0]);
    }
    console.log(`Took ${Date.now() - startedAt}ms`);

  } catch (err) {
    console.error(err);
  }
}

retrieveHistoricalCandles();