ml4t-data
Market data acquisition, storage, and update workflows for machine learning for trading.
Use ml4t-data to fetch and validate market data, keep local datasets current, and provide
repeatable inputs to research and trading workflows. It includes adapters for equities, futures,
foreign exchange, crypto assets, macroeconomic series, factors, and prediction markets.
Installation
ml4t-data supports CPython 3.12, 3.13, and 3.14 on Linux, macOS, and Windows. Python 3.15 is
temporarily excluded while upstream dependencies complete their compatibility work.
pip install ml4t-data
Provider-specific integrations are optional. Install ml4t-data[yahoo],
ml4t-data[databento], ml4t-data[oanda], or ml4t-data[cot] when those adapters are
needed. Some providers require network access, an account, credentials, or metered data. The
provider guide records each boundary.
Quick start
The synthetic provider exercises the public OHLCV interface without network access or credentials.
from ml4t.data.providers import SyntheticProvider
provider = SyntheticProvider(seed=42)
data = provider.fetch_ohlcv("SYNTH", "2024-01-01", "2024-01-10", "daily")
assert not data.is_empty()
assert {"timestamp", "symbol", "open", "high", "low", "close", "volume"} <= set(data.columns)
Set ML4T_DATA_PATH to choose the root directory for local datasets. Without an explicit path,
the library uses ./data in the current working directory.
Migration from QLDM names
Existing deployments may continue to use QLDM_DATA_ROOT and import QldmError. Both names
emit DeprecationWarning and will not be removed before version 1.0.
- Replace
QLDM_DATA_ROOTwithML4T_DATA_PATH. - Replace
QldmErrorwithML4TDataErrorfromml4t.data.core.exceptions.
Documentation and support
The library supplies data to ml4t-engineer feature workflows and
ml4t-backtest simulations. Neither package is required to use
ml4t-data.
Development
git clone https://github.com/ml4t/data.git
cd data
uv sync --all-extras --all-groups
uv run pre-commit install
uv run ruff check src/ tests/
uv run ruff format --check src/ tests/
uv run ty check
uv run pytest tests/ -q
uv run mkdocs build --strict
uv build
Pull requests must preserve offline deterministic tests. Provider contract tests that require credentials run in explicit integration lanes.
1 maintainer
Release files for ml4t-data 0.2.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| ml4t_data-0.2.0.tar.gz | 771.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ml4t_data-0.2.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 1.3 MB
Release files / ml4t_data-0.2.0.tar.gz
| Download URL | ml4t_data-0.2.0.tar.gz |
|---|---|
| Size | 771.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
21277a51b280215964c03f62d4052b0058c418d8694199baf2f324588828426c
|
|
BLAKE2b-256 checksum How to use checksums |
b249d99b2f3121246fb63e69df5ddd8bbb28212e06fb512e1c1f128407fc7757
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency logRelease files / ml4t_data-0.2.0-py3-none-any.whl
| Download URL | ml4t_data-0.2.0-py3-none-any.whl |
|---|---|
| Size | 481.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
929abebf3d881ea5aca4b75dbafbc816876b978f8c58a9b3b7adab6843607354
|
|
BLAKE2b-256 checksum How to use checksums |
bc71843d2bc6f112358db688fd24dada744078a0af32de1a2b3fb38515119a36
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 25, 2026.
Transparency log
