iturri 0.1.0__py3-none-any.whl

iturri/__init__.py

@@ -0,0 +1,87 @@
+"""iturri — client for the Iturri verified market-data API.
+
+Every bar carries a quality flag; filter on it. Zero hard dependencies;
+if pandas is installed, bars() and features() return DataFrames.
+
+    import iturri
+    df = iturri.bars("BTC", "1h", start="2024-01-01", end="2024-02-01")
+    df = df[df.quality == "verified"]
+
+Iturri sells data and tooling only — nothing it returns is a trading
+signal, a prediction, or financial advice.
+"""
+
+from __future__ import annotations
+
+import json
+import urllib.parse
+import urllib.request
+
+__version__ = "0.1.0"
+BASE_URL = "https://iturri-data.odd-haze-3940.workers.dev"
+
+QUALITY = {0: "verified", 1: "raw", 2: "reconciled", 3: "interpolated",
+           4: "disputed", 5: "outage"}
+
+
+def _get(path: str, params: dict | None = None) -> dict:
+    url = BASE_URL + path
+    if params:
+        url += "?" + urllib.parse.urlencode({k: v for k, v in params.items()
+                                             if v is not None})
+    req = urllib.request.Request(url, headers={"User-Agent": f"iturri-py/{__version__}"})
+    with urllib.request.urlopen(req, timeout=60) as r:
+        return json.loads(r.read())
+
+
+def _maybe_frame(data: dict, quality_key: str | None = None):
+    """Columnar dict → DataFrame when pandas is available, else plain dict."""
+    try:
+        import pandas as pd
+    except ImportError:
+        return data
+    d = dict(data)
+    t = pd.to_datetime(d.pop("t"), unit="s", utc=True).tz_convert(None)
+    if quality_key and quality_key in d:
+        d["quality"] = [QUALITY.get(q, "raw") for q in d.pop(quality_key)]
+    df = pd.DataFrame(d, index=t)
+    df.index.name = "timestamp"
+    return df
+
+
+def catalog() -> dict:
+    """Full catalog: symbols, timeframes, ranges, pricing, quality legend. Free."""
+    return _get("/api/catalog")
+
+
+def bars(symbol: str, tf: str, start: str | None = None, end: str | None = None):
+    """Quality-flagged OHLCV. Returns a DataFrame (pandas) or columnar dict.
+
+    tf: crypto "1h"/"1d" · equities "1d_raw" (as-traded) / "1d_split".
+    """
+    r = _get("/api/bars", {"symbol": symbol, "tf": tf, "start": start, "end": end})
+    out = _maybe_frame(r["data"], quality_key="q")
+    if not isinstance(out, dict):
+        out = out.rename(columns={"o": "open", "h": "high", "l": "low",
+                                  "c": "close", "v": "volume"})
+        out.attrs.update({k: r[k] for k in ("symbol", "tf", "datacard", "price_usd")
+                          if k in r})
+    return out
+
+
+def features(symbol: str, tf: str, start: str | None = None, end: str | None = None):
+    """Documented leakage-safe feature matrix rows (19 features + regime)."""
+    r = _get("/api/features", {"symbol": symbol, "tf": tf, "start": start, "end": end})
+    return _maybe_frame(r["data"])
+
+
+def bundle(pack: str) -> dict:
+    """Signed download URLs for a training pack: 'crypto' or 'equities'."""
+    req = urllib.request.Request(
+        BASE_URL + "/api/bundle", data=json.dumps({"pack": pack}).encode(),
+        headers={"Content-Type": "application/json",
+                 "User-Agent": f"iturri-py/{__version__}"})
+    with urllib.request.urlopen(req, timeout=60) as r:
+        out = json.loads(r.read())
+    out["signed_urls"] = [BASE_URL + u for u in out.get("signed_urls", [])]
+    return out

iturri-0.1.0.dist-info/METADATA

@@ -0,0 +1,28 @@
+Metadata-Version: 2.4
+Name: iturri
+Version: 0.1.0
+Summary: Client for the Iturri verified market-data API — every bar verified or flagged
+Author: Iturri
+License: MIT
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+Provides-Extra: pandas
+Requires-Dist: pandas>=2.0; extra == "pandas"
+
+# iturri
+
+Client for the [Iturri](https://iturri-data.odd-haze-3940.workers.dev) verified
+market-data API. Every bar quality-flagged; filter on it.
+
+```python
+import iturri
+
+iturri.catalog()                          # free discovery
+df = iturri.bars("BTC", "1h", start="2024-01-01", end="2024-02-01")
+df = df[df.quality == "verified"]         # the whole point
+feats = iturri.features("SPY", "1d_split", start="2026-06-01")
+iturri.bundle("crypto")                   # signed training-pack URLs
+```
+
+Zero hard dependencies. With pandas installed you get DataFrames; without it,
+columnar dicts. Data and tooling only — never signals or advice.

iturri-0.1.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+iturri/__init__.py,sha256=FWnS396JeXZCIk4IIgRsSNTfUUZFVPdCvov9UuEVtko,3296
+iturri-0.1.0.dist-info/METADATA,sha256=44CmDLTT2jjfqvdoERJKAUQW1fNM2q4CT6OXVmVCF6g,945
+iturri-0.1.0.dist-info/WHEEL,sha256=K260EYznzXsJYBQGqmI8VTxEdiZYNvDZwW9cBh9-_MA,91
+iturri-0.1.0.dist-info/top_level.txt,sha256=smA6D5_GyB6MqLCrvMfDLyjbOUK_J9IDe0S7bROOv44,7
+iturri-0.1.0.dist-info/RECORD,,

iturri-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (83.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

iturri-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+iturri