xret-data
Trusted market data infrastructure for Xret.
Acquire, validate, and store crypto trade bars, settled funding, mark/index/premium-index reference bars, and sampled open interest with explicit I/O boundaries and fail-closed quality guarantees. Consume typed live trade-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 fetch or change historical storage. Applications compose historical and live observations according to their own continuity policy:
async with md.live(exchange="binance") as live:
await live.subscribe_bar_updates(bars)
update = await anext(live)
Key contracts
fetch— explicit latest or final remote-only bar 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 trade-bar delivery, never fetches or writes historical stateMarketData(provider="binance-data-vision")— qualified BinanceBTC/USDTUSDⓈ-M5mOI archives only; no CCXT or REST fallback
Links
1 maintainer
Metadata
1 maintainer
Release files for xret-data 0.6.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.6.0.tar.gz | 124.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| xret_data-0.6.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 282.0 kB
Release files / xret_data-0.6.0.tar.gz
| Download URL | xret_data-0.6.0.tar.gz |
|---|---|
| Size | 124.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
584a6f4df1fb5d86e4c32497bdddbb181d94f3952eb6f450eba25335d4d6cca8
|
|
BLAKE2b-256 checksum How to use checksums |
433a33bafbe53d129b11bf55175b2bc76f1116b4b86d12bace9742ee28155152
|
| 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.6.0-py3-none-any.whl
| Download URL | xret_data-0.6.0-py3-none-any.whl |
|---|---|
| Size | 157.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f7c66ad0be80c5958d0bb8af83250c45e298ab180e3eb23e1e4a3b238865dd4d
|
|
BLAKE2b-256 checksum How to use checksums |
9a16da985707f281e84910a2c4e7502082b579c3c7e6e07b696f3ff6dc617d37
|
| 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}
|
