Açık Kaynak

histdata: Geçmiş Verileri İndirin

histdata.com üzerinden geçmiş piyasa verilerini indirin ve M1 mumlarını sıkıştırılmış Apache Parquet biçimine dönüştürün. Yerel araştırmalar için 34 enstrüman arasından seçim yapın.

Python 3.10+Apache ParquetzstdMIT Lisansı34 Enstrüman
GitHub’da görüntüle
CLI Örneği
$ pip install git+https://github.com/StratCraftsAI/histdata.git
$ histdata --pairs EURUSD GBPUSD --year-start 2020 --year-end 2025
Örnek çıktı: her enstrüman için bir Parquet dosyası
output/EURUSD_M1.parquet
output/GBPUSD_M1.parquet

Özellikler

Yerel bir piyasa veri kümesi oluşturun ve nicel analizden önce kapsamını inceleyin.

34 Enstrüman

23 döviz çifti, iki emtia (WTI ve Brent) ve S&P 500, Nikkei ve DAX dahil dokuz endeks.

Apache Parquet Çıktısı

pandas, Polars, DuckDB ve diğer Arrow uyumlu araçlarla okunabilen, zstd sıkıştırmalı Parquet.

Komut Satırı Aracı

pip ile kurun; histdata komutuyla enstrümanları ve yılları seçin.

Arşiv Seçimi

M1 indirmeleri, istenen tarih aralığı için mevcut yıllık veya aylık arşivleri seçer ve doğrulanmış yerel arşivleri yeniden kullanır.

Türleri Belirlenmiş Şema

OHLCV sütunları timestamp[ms] ve float64 kullanır. Analizden önce kaynak saat dilimini ve seçilen CLI iş akışını inceleyin.

Python Bağımlılıkları

requests, beautifulsoup4, pyarrow ve filelock kullanır. Python 3.10 veya üzeri gereklidir.

İşlem Adımları

Arşivleri indirin, M1 verilerini ayrıştırın ve sütun türleri belirlenmiş Parquet dosyalarını yazın.

1
Belirteci Çıkar
→
2
ZIP İndir
→
3
M1 CSV Ayrıştır
→
4
Parquet Yaz
histdata.com → ZIP (CSV) → list[OHLCVRow] → Parquet (zstd)

Desteklenen Enstrümanlar

Döviz, emtia ve küresel endekslerden oluşan 34 enstrüman. Mevcut geçmiş veri kapsamı enstrümana göre değişir.

Döviz 23

Ana Pariteler

EURUSDGBPUSDUSDJPYUSDCHFUSDCADAUDUSDNZDUSD

Çapraz Pariteler

EURAUDEURCADEURCHFEURGBPEURNZDGBPAUDGBPCADGBPCHFGBPNZDAUDNZD

JPY Çaprazları

AUDJPYCADJPYCHFJPYEURJPYGBPJPYNZDJPY

Emtialar 2

BCOUSDBrent Crude Oil
WTIUSDWTI Crude Oil

Endeksler 9

AUXAUDASX 200
FRXEURCAC 40
GRXEURDAX 30
HKXHKDHang Seng
JPXJPYNikkei 225
NSXUSDNASDAQ 100
SPXUSDS&P 500
UDXUSDUS Dollar Index
UKXGBPFTSE 100

Çıktı Şeması

Türleri belirlenmiş Parquet sütunları. Veri kümelerini birleştirmeden önce zaman damgalarını ve veri kalitesini doğrulayın.

SütunTürAçıklama
timestamptimestamp[ms]Mum zamanı; normal M1 indirmeleri UTC kullanır, --skip-download kaynak EST zamanını korur
openfloat64Açılış fiyatı
highfloat64En yüksek fiyat
lowfloat64En düşük fiyat
closefloat64Kapanış fiyatı
volumefloat64Kaynağın hacim alanı
Kaynakhistdata.com — Noktalı virgülle ayrılmış genel ASCII CSV; API anahtarı gerekmez
Kaynak Saat DilimiEST (UTC-5, yaz saati uygulaması olmadan)
BiçimApache Parquet + zstd

Hızlı Başlangıç

GitHub üzerinden kurun ve ihtiyacınız olan enstrümanları ve tarih aralığını seçin.

Kurulum
pip install git+https://github.com/StratCraftsAI/histdata.git
CLI Kullanımı
# Download EURUSD 2020-2025 and convert to Parquet
histdata --pairs EURUSD --year-start 2020 --year-end 2025

# Multiple pairs
histdata --pairs EURUSD GBPUSD USDJPY --year-start 2015 --year-end 2025

# All 34 instruments
histdata --pairs all --year-start 2020 --year-end 2025
pandas ile Okuma
import pandas as pd

df = pd.read_parquet("output/EURUSD_M1.parquet")
print(df.head())
#              timestamp     open     high      low    close  volume
# 0 2023-01-02 17:00:00  1.07045  1.07048  1.07045  1.07048     0.0

CLI Seçenekleri

SeçenekVarsayılanAçıklama
--pairsDöviz (23)İndirilecek enstrümanlar. 34 enstrümanın tamamı için "all" kullanın.
--year-start2020İndirilecek ilk yıl.
--year-end2025İndirilecek son yıl.
--timeframeM1M1, bir dakikalık mumları dönüştürür. tick seçeneği arşivleri indirir ancak tik ayrıştırıcısı veya Parquet çıktısı bulunmaz.
--output-dir./outputParquet çıktı dosyalarının dizini.
--zip-dir./downloadsİndirilen ZIP arşivlerinin dizini.
--skip-downloadoffYalnızca mevcut M1 ZIP dosyalarını dönüştürür; kaynak EST zaman damgalarını korur.
-v, --verboseoffHata ayıklama günlüklerini etkinleştirir.

Sık Sorulan Sorular

API anahtarına ihtiyacım var mı?

API anahtarı gerekmez. Araç, indirmeden önce histdata.com üzerinden bir arşiv belirteci alır.

İndirme ne kadar sürer?

Süre; mevcut arşivlerin sayısına ve boyutuna, ağa ve yerel işleme bağlıdır. Araç, istek hızını sınırlar; tamamlanma süresi garanti edilmez.

Çıktıyı nicel araştırmalar için kullanabilir miyim?

M1 Parquet dosyaları pandas veya diğer Parquet uyumlu araçlarla okunabilir. Bir araştırma platformuna aktarmadan önce veri kapsamını, kalitesini, sütun eşleştirmesini ve saat dilimi gereksinimlerini kontrol edin.

Zaman damgaları hangi saat diliminde?

Kaynak CSV, yaz saati uygulaması olmadan sabit EST (UTC-5) kullanır. Normal M1 indirmeleri UTC’ye dönüştürür. --skip-download iş akışı, ayrıştırılmış kaynak EST değerlerini korur. Parquet timestamp[ms] saat dilimi meta verisi içermez.

Tik verileri destekleniyor mu?

--timeframe tick seçeneği tik arşivlerini indirebilir, ancak tik ayrıştırma ve Parquet dönüşümü uygulanmamıştır. Belgelenen OHLCV çıktısı için M1 kullanın.

Başlayın

MIT lisanslı açık kaynaklı yazılım. Daha geniş kullanım öncesinde kaynak kodunu inceleyin ve küçük bir veri kümesini doğrulayın.