iturri 0.1.0__tar.gz

iturri-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,17 @@
+# 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/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/iturri.egg-info/PKG-INFO

@@ -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/iturri.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+README.md
+pyproject.toml
+iturri/__init__.py
+iturri.egg-info/PKG-INFO
+iturri.egg-info/SOURCES.txt
+iturri.egg-info/dependency_links.txt
+iturri.egg-info/requires.txt
+iturri.egg-info/top_level.txt

iturri-0.1.0/iturri.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

iturri-0.1.0/iturri.egg-info/requires.txt

@@ -0,0 +1,3 @@
+
+[pandas]
+pandas>=2.0

iturri-0.1.0/iturri.egg-info/top_level.txt

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

iturri-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=68"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "iturri"
+version = "0.1.0"
+description = "Client for the Iturri verified market-data API — every bar verified or flagged"
+readme = "README.md"
+requires-python = ">=3.9"
+license = { text = "MIT" }
+authors = [{ name = "Iturri" }]
+# zero hard deps; pandas is optional and auto-detected
+[project.optional-dependencies]
+pandas = ["pandas>=2.0"]
+
+[tool.setuptools]
+packages = ["iturri"]

iturri-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+