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 forming live bars 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 forming bars use an explicit async session and never change historical storage:
async with md.live(exchange="binance") as live:
await live.subscribe_bar_updates(bars)
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 forming-bar delivery, never writes historical state
Links
Metadata
Release files for xret-data 0.3.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.3.0.tar.gz | 68.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xret_data-0.3.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 153.2 kB
Release files / xret_data-0.3.0.tar.gz
| Download URL | xret_data-0.3.0.tar.gz |
|---|---|
| Size | 68.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
4d36d9cf1dbdc43ff5040e6844844ffd5b9125f776675deb1be22eb865c912db
|
|
BLAKE2b-256 checksum How to use checksums |
18285287c5d4d54334095c99b80d492ed31a3c100003861b886d2b25feb93b5a
|
| 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.3.0-py3-none-any.whl
| Download URL | xret_data-0.3.0-py3-none-any.whl |
|---|---|
| Size | 84.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b24e3ee45857403f776349ed57c88b01ca762178fd3664ee426989d2ea918111
|
|
BLAKE2b-256 checksum How to use checksums |
b121c63cf630ada1efadefc85ab5b73a0f02db539f5750f31279a451b7219868
|
| 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}
|