Skip to main content

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 state
  • sync — reconcile missing coverage, commit validated Parquet
  • scan — strict local read, raises CoverageError on gaps
  • scan_partial — local read with structured gap reporting
  • live — 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)

Source distribution for xret-data 0.3.0
File Size Uploaded
xret_data-0.3.0.tar.gz 68.6 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for xret-data 0.3.0
File Interpreter ABI Platform
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}

Release history Release notifications | RSS feed

0.6.0

2 release files

0.5.1

2 release files

0.5.0

2 release files

0.4.0

2 release files

This release

0.3.0 This release

2 release files

0.2.1

2 release files

0.1.0

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page