Python · ForeignExchangeData op GitHub

Wat het is

Een public domain dataset met EUR/USD prijsbars, 2-minuten intervallen, heel 2025. Naast de data staan er twee kleine scripts: één om de bars te laden en te resamplen, één om ze te plotten. Dit is geen tradingsysteem. Het bestaat zodat iedereen backtests, indicators of analyses kan proberen op FX-data die er realistisch uitziet, zonder eerst een broker-feed te moeten opzetten.

Dit is een sandbox repository. Er is geen garantie op juistheid of volledigheid van de data, en ze moet niet gebruikt worden voor echte tradingbeslissingen. De data en code zijn vrijgegeven onder CC0, dus mogen voor elk doel gebruikt, gekopieerd, aangepast en gedeeld worden.

De data

Één CSV-bestand per maand, data/eurusd_2m_2025-MM.csv, twaalf bestanden in totaal. Elke rij is een 2-minuten bar.

  • datetime — tijdstip van de bar, UTC
  • open — openingsprijs
  • high — hoogste prijs
  • low — laagste prijs
  • close — slotprijs
  • volume — verhandeld volume
  • trade_count — aantal trades in de bar

Laden en resamplen

scripts/data_tools.py heeft vier functies. load_month leest de CSV van één maand in een DataFrame, geïndexeerd op datetime en gesorteerd. load_months laadt meerdere maanden en voegt ze samen tot één gesorteerde DataFrame, waarbij dubbele timestamps op de naden eruit worden gehaald. load_all is load_months over elk bestand dat in data/ gevonden wordt. resample neemt een DataFrame en een pandas offset alias, zoals "1h" of "1D", en aggregeert naar die bar-grootte: eerste open, hoogste high, laagste low, laatste close, opgeteld volume en trade count.

from scripts.data_tools import load_months, load_all, resample

df = load_months(["2025-01", "2025-02"])  # combine specific months
df = load_all()                           # combine all available months
hourly = resample(df, "1h")               # resample to any pandas offset alias

available_months() laat zien welke maanden een CSV-bestand hebben, door de map data/ uit te lezen. De andere laadfuncties gebruiken deze intern, en het plotscript vult er ook --all mee aan.

Plotten

scripts/visualize.py is een klein command-line script. Het laadt één of meer maanden, resampled ze, en tekent twee charts onder elkaar: slotprijs met de high/low-range erachter geschaduwd, en volume als staafdiagram daaronder, groen of rood afhankelijk van of de bar omhoog of omlaag sloot.

pip install -r requirements.txt
python scripts/visualize.py 2025-01
python scripts/visualize.py --all
python scripts/visualize.py --all --resample 1h

De --resample flag staat standaard op 1h. Geef een willekeurige pandas offset alias mee, zoals 5min of 1D, om de bar-grootte te veranderen voordat er geplot wordt. Het hele jaar plotten op de native 2-minuten resolutie is traag en onoverzichtelijk, dus resamplen is de moeite waard voor alles langer dan een paar maanden.

Projectstructuur

data/
    eurusd_2m_2025-01.csv   # one file per month
    ...
    eurusd_2m_2025-12.csv

scripts/
    data_tools.py           # load_month, load_months, load_all, resample
    visualize.py             # command-line plotting script

CITATION.cff                # how to cite this dataset
LICENSE                      # CC0 1.0

Verwijs je naar deze data in een paper of write-up? Zie CITATION.cff in de repository.