tt-data-store
Work with a shared market-data archive as if it were a local folder — backed by S3.
tt-data-store on PyPI · GitHub
New here? Start with the usage guide.
The idea
You have candle data (OHLCV) stored as Parquet files on S3. Multiple people or jobs need to read and write that data without stepping on each other.
MarketStore gives you a local working copy of the archive:
- Open a folder → catalogue syncs from S3 (instruments + file list)
- Call
read()→ downloads only the Parquet you need - Call
write()+publish()→ share your changes
You never manage S3 keys or checksums by hand.
Install
pip install "tt-data-store[s3]"
Python 3.11+. The [s3] extra installs boto3.
30-second example
from tt_data_store import Instrument, MarketStore
store = MarketStore(
"./data",
remote="s3://my-bucket/archive",
region="us-east-1",
)
nifty = Instrument.index("NSE", "NIFTY")
# Read
df = store.read(nifty, start="2026-01-01", end="2026-01-31")
# Write
store.write(nifty, df, source="my-collector", register=True)
store.publish()
Documentation
| Guide | What you'll learn |
|---|---|
| Usage guide | Concepts, setup, reading, writing, sync |
| API reference | Method signatures and types |
When to use what
| You want to… | Call |
|---|---|
| Check if remote moved ahead | store.drift() |
| Catch up with remote | store.sync() or store.pull() |
| Load candles | store.read(instrument, start=..., end=...) |
| Save candles locally | store.write(instrument, candles, source=..., register=True) |
| Share changes | store.publish() |
| See sync state | store.status() |
Development
git clone https://github.com/Tiny-Trader/data-store.git
cd data-store
uv sync --extra dev --extra s3
uv run pytest
License
Apache-2.0 — see LICENSE.
1 maintainer
Metadata
1 maintainer
Release files for tt-data-store 2.0.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 | Provenance | |
|---|---|---|---|---|
| tt_data_store-2.0.0.tar.gz | 29.8 kB | With provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tt_data_store-2.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 67.4 kB
Release files / tt_data_store-2.0.0.tar.gz
| Download URL | tt_data_store-2.0.0.tar.gz |
|---|---|
| Size | 29.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
5ebc85a97a2f8da859e93182c24051e6ff3dd8100361d0b72f17000314363c77
|
|
BLAKE2b-256 checksum How to use checksums |
7439b870cf278a1545d851ca6f8cf7c9d6d7697fd8c2edc4015bdd5faec73862
|
| 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 Aug 27, 2026.
Transparency logRelease files / tt_data_store-2.0.0-py3-none-any.whl
| Download URL | tt_data_store-2.0.0-py3-none-any.whl |
|---|---|
| Size | 37.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7bb1c138551b6b7a469b7e078aa84c4a4d36ecc5780b1e9a2094edb1dcc79ca1
|
|
BLAKE2b-256 checksum How to use checksums |
9ce06e254e5778565b006ce0126bca798e665adaa739be3b4aad56e23e262fe8
|
| 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 Aug 27, 2026.
Transparency logSecurity for tt-data-store 2.0.0
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.
Full provenance
All 2 files in this release have been uploaded with provenance metadata.
Attestation for tt_data_store-2.0.0.tar.gz
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 Aug 27, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
