Introduction

Welcome to MetaSync Forex. We turn chaos into infrastructure.

What is this tool?

Imagine you want to study the history of currency prices (like the Euro vs. Dollar) to find patterns. The raw data is massive—millions of price changes ("ticks") happening every second, every day, for years.

MetaSync Forex is your automated data factory. It fetches this raw, messy data from the internet, cleans it up, organizes it into a high-speed digital library, and adds "smart" information (like "was the London market open?").

The Result: Instead of thousands of messy ZIP files, you get one smart DuckDB file that answers your questions instantly.

How does it work?

1

The Scout

It scans your library. If you have data up to October and it's now December, it only fetches the missing 2 months.

2

The Collector

Downloads raw logs securely from institutional brokers. Handles both Raw Spread (precision) and Standard (retail) data.

3

The Librarian

Stuffs millions of records into a single high-performance DuckDB file. Querying is milliseconds, not minutes.

4

The Analyst

Enriches data with session info (London/NY open?) and calculates OHLC candles automatically.

Quick Look

Once installed, downloading 10 years of data is one command:

Terminal
$uv run scripts/quick_start.py