dukascopy-node

✨ Download free historical market price tick data ✨
Stocks • Crypto • Commodities • Bonds • Currencies • CFDs • ETFs
via Node.js and CLI

📚 Documentation

🚀 Installation

npm	yarn	pnpm
npm install dukascopy-node --save	yarn add dukascopy-node	pnpm add dukascopy-node

✨ Usage via CLI

npx dukascopy-node -i btcusd -from 2019-01-13 -to 2019-01-14 -t tick -f csv

🛠️ View full CLI specification

✨ Usage via Node.js (try it live)

const { getHistoricalRates } = require('dukascopy-node');

(async () => {
  try {
    const data = await getHistoricalRates({
      instrument: 'btcusd',
      dates: {
        from: new Date('2019-01-13'),
        to: new Date('2019-01-14')
      },
      timeframe: 'tick',
      format: 'json'
    });

    console.log(data);
  } catch (error) {
    console.log('error', error);
  }
})();

🛠️ View full Node.js specification

📖 Quick start

• Basic usage of dukascopy-node
• Downloading tick data
• Date formatting and converting timezones
• Dealing with empty data and errors
• Downloading data with cache
• Downloading data with custom batching
• Usage with typescript
• Debugging

📂 Instruments

• Bonds 📊 (3)
• Crypto assets ₿ (33)
• Agricultural commodities ☕ (6)
• Energy commodities ⚡ (4)
• Metals commodities ⚙️ (3)
• Germany ETFs 🇩🇪📈 (1)
• France ETFs 🇫🇷📈 (3)
• Hong Kong ETFs 🇭🇰📈 (4)
• United States ETFs 🇺🇸📈 (62)
• Forex currencies 💱 (293)
• Forex major currencies 💶 (7)
• Forex metals 🥇 (51)
• America 🌎 (6)
• Asia 🌏 (6)
• Europe 🇪🇺 (9)
• Africa 🌍 (1)
• Austria 🇦🇹 (3)
• Belgium 🇧🇪 (7)
• Denmark 🇩🇰 (8)
• Finland 🇫🇮 (7)
• France 🇫🇷 (41)
• Germany 🇩🇪 (44)
• Hong Kong 🇭🇰 (27)
• Ireland 🇮🇪 (5)
• Italy 🇮🇹 (48)
• Japan 🇯🇵 (55)
• Mexico 🇲🇽 (29)
• Netherlands 🇳🇱 (17)
• Norway 🇳🇴 (6)
• Portugal 🇵🇹 (2)
• Spain 🇪🇸 (24)
• Sweden 🇸🇪 (20)
• Switzerland 🇨🇭 (28)
• United Kingdom 🇬🇧 (102)
• United States 🇺🇸 (608)
• ETFs 📈 (34)

  ---

  Bonds 📊

Changelog

All notable changes to this project will be documented in this file. See standard-version for commit guidelines.

1.43.0 (2025-06-16)

Features

• new instruments jun 2025 (#212) (edd54c8)

1.42.1 (2025-03-02)

Bug Fixes

• start dates for some intstruments (#206) (c745c78)

1.42.0 (2025-01-12)

Features

• new instruments jan 2025 (#203) (251ad85)

1.41.0 (2024-11-28)

Features

• new instruments Nov 2024 (#199) (44d7ca4)

1.40.0 (2024-08-08)

Features

• more sensible error codes (#189) (d0fe496)

1.39.3 (2024-07-06)

1.39.2 (2024-06-19)

Bug Fixes

• restore metadata (#182) (ca64a92)

1.39.1 (2024-06-19)

Bug Fixes

• custom decimal factor for some instruments (#181) (67c6903)

1.39.0 (2024-06-03)

Features

• new instruments Jun 2024 (#177) (6855c03)

1.38.0 (2024-03-19)

Features

• new crypto instruments (#171) (b2e2a77)

1.37.0 (2024-03-04)

Features

• cli: format dates (#170) (1b4292f)

1.36.2 (2023-09-17)

Bug Fixes

• cli: file name with hours and minutes (#160) (e52ff34)

1.36.1 (2023-09-06)

Bug Fixes

• cli: custom file name extension (#159) (5509957)

1.36.0 (2023-09-06)

Features

• cli: allow custom file name (#157) (ed20c0d)
• update metadata (#158) (b92dbe8)

1.35.1 (2023-07-22)

Bug Fixes

• lzma purejs version and pkg fix (#150) (dd19d62)

1.35.0 (2023-05-14)

Features

• retry on empty response (#134) (5ac13ba)

1.34.0 (2023-03-30)

Features

• skip waiting if batch cache hit (#128) (3dca755)

1.33.0 (2023-03-01)

Features

• volume units (#127) (4ce98ec)

1.32.0 (2023-03-01)

Features

• cli: download time (#125) (e891bf2)
• retry artifact download on server error (#126) (2e12810)

1.31.3 (2023-02-23)

Bug Fixes

• cli: memory leak fix (#119) (f4e0488)

1.31.2 (2023-02-15)

Bug Fixes

• lzma-purejs as cjs (#118) (243d4ca)

1.31.1 (2023-02-03)

Bug Fixes

• proper core types (#115) (f62c4f8)

1.31.0 (2023-01-31)

Features

• node: debug os info (#112) (a3922ac)
• node: realtime rates (#111) (59513a7)

1.30.1 (2023-01-14)

1.30.0 (2023-01-04)

Features

• cli: os debug info (#105) (08e9825)

1.29.0 (2022-11-06)

Features

• new instruments for Mexico (#102) (8ca6147)

Bug Fixes

• date formatting for readme (5a93430)

1.28.0 (2022-11-01)

Features

• new instruments (Nov 2022) (#101) (91956c1)

1.27.0 (2022-10-23)

Features

• secondly timeframe (#98) (8d83118)

Bug Fixes

• cli: empty file stats lookup (#99) (5a9f8af)

1.26.0 (2022-10-22)

Features

• cli: save file via writable stream (#97) (3039543)

1.25.0 (2022-08-24)

Features

• cli: inline output (#93) (941d10c)

1.24.0 (2022-08-21)

Features

• cli: human readable output for instrument and dates (#91) (4473a6f)

1.23.0 (2022-08-19)

Features

• cli: display size of output file (#90) (32aab61)

1.22.2 (2022-08-18)

Bug Fixes

• cli: proper file name when date out of bound (#89) (15d4cdf)

1.22.1 (2022-08-09)

Bug Fixes

• proper start dates (#86) (b17a2bd)

1.22.0 (2022-08-03)

Features

• new instruments (Aug 2022) (#84) (c07c158)

1.21.0 (2022-05-29)

Features

• cli: print relative path to file instead of file name in the success message (#80) (7f6d374)

1.20.0 (2022-05-27)

Features

• support "now" in and "to" cli parameter. (#77) (efe3187)

1.19.3 (2022-05-27)

Bug Fixes

• fix for empty tick to minute aggregations (#78) (8cecc89)

1.19.2 (2022-05-13)

Bug Fixes

• proper name for getHistoricalRates function (#73) (51acaaa)

1.19.1 (2022-05-09)

1.19.0 (2022-05-05)

Features

• add lib and node version to debug (#71) (51b69a0)
• analytics ip (#70) (3cc2e5a)

1.18.0 (2022-05-02)

Features

• analytics update (#69) (5fe8934)

1.17.0 (2022-05-02)

Features

• adding plausible analytics (#68) (40eb2c8)

1.16.0 (2022-04-28)

Features

• added debugging for node and cli (#67) (c4cf3e8)

1.15.0 (2022-04-24)

Features

• cli empty data warning msg (#66) (cf77a40)

1.14.3 (2022-04-24)

Bug Fixes

• cli graceful handling of shutdown and non-200 responses (#65) (894bfb2)

1.14.2 (2022-04-23)

Bug Fixes

• proper m5 and h4 date normalisation (#64) (2024b4e)

1.14.1 (2022-04-23)

Bug Fixes

• changed node engine restrictions (1d73fb7)

1.14.0 (2022-04-23)

Features

• new intstruments - Apr 2022 (#63) (2cc33a7)

1.13.1 (2022-04-23)

Bug Fixes

• fs-extra as dep insted of dev-dep (ca77cbb)

1.13.0 (2022-04-23)

Features

• move cli under dukascopy-node package (15d7e47)

1.12.0 (2022-04-23)

Features

• accurate start times (#45) (8926f1b)
• add retry on fetch fail (#49) (c05d71d)
• file-cache (4d62b19)
• more timeframes (m5 and h4) (#53) (0fec595)
• new instruments - Aug 2021 (#50) (7fe0a62)
• new instruments (Nov 2021) (#54) (28258f3)
• new instruments as of April, 2021 (0ebb9e1)
• new instruments June 2021 (#42) (cf8cf94)