xret-data
Trusted market data infrastructure for Xret.
Acquire, validate, and store crypto market data with explicit I/O boundaries and fail-closed quality guarantees. Consume typed live bar observations through the same provider-neutral market identity.
Install
uv add xret-data
Quick start
from xret.data import MarketData
md = MarketData()
bars = md.bars(
exchange="binance", symbol="BTC/USDT",
market="perpetual", settle="USDT", timeframe="1h",
)
result = bars.sync("2024-01-01", "2024-06-01")
result.require_complete()
df = bars.scan("2024-01-01", "2024-06-01").collect()
Live bars use an explicit async session and never change historical storage. Opt into a recent snapshot-to-live handoff when the consumer needs an ordered transition from historical data:
async with md.live(exchange="binance") as live:
await live.subscribe_bar_updates(bars, bootstrap=True)
update = await anext(live)
Key contracts
fetch— remote-only observation, never touches local statesync— reconcile missing coverage, commit validated Parquetscan— strict local read, raisesCoverageErroron gapsscan_partial— local read with structured gap reportinglive— explicit async bar delivery and optional recent bootstrap, never writes historical state
Links
1 maintainer
Metadata
1 maintainer
Release files for xret-data 0.5.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 | |
|---|---|---|---|
| xret_data-0.5.0.tar.gz | 76.4 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xret_data-0.5.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 170.2 kB
Release files / xret_data-0.5.0.tar.gz
| Download URL | xret_data-0.5.0.tar.gz |
|---|---|
| Size | 76.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
2fff9170c5ec2888917b48c38db094dbd230bf3d822feaf3c46b578476839521
|
|
BLAKE2b-256 checksum How to use checksums |
67104c9bbf01453e440c629c5ada23afdd4187d982d489b4d86e20e1027b2d59
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / xret_data-0.5.0-py3-none-any.whl
| Download URL | xret_data-0.5.0-py3-none-any.whl |
|---|---|
| Size | 93.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4bed71218914c11e626d37336190cb687f02329b9b325dc29575439522bb75ec
|
|
BLAKE2b-256 checksum How to use checksums |
e6d778ad8a9a1be2de0df36d6cbc64ca44145c5f36b4c10d465a2d19566e03a1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
