iturri 0.1.0

package/cli.mjs

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+// iturri CLI — query the verified market-data catalog from the terminal.
+//   iturri catalog
+//   iturri bars BTC 1h --start 2024-01-01 --end 2024-02-01
+//   iturri features SPY 1d_split --start 2026-06-01
+//   iturri bundle crypto
+
+import { catalog, bars, features, bundle } from "./index.mjs";
+
+const [cmd, ...rest] = process.argv.slice(2);
+const flags = {};
+const args = [];
+for (let i = 0; i < rest.length; i++)
+  rest[i].startsWith("--") ? (flags[rest[i].slice(2)] = rest[++i]) : args.push(rest[i]);
+
+const out = (x) => console.log(JSON.stringify(x, null, 1));
+
+try {
+  if (cmd === "catalog") {
+    const c = await catalog();
+    const syms = Object.entries(c.symbols).map(([s, v]) =>
+      `${s.padEnd(6)} ${v.asset.padEnd(7)} ${Object.keys(v.tfs).join(" ")}`);
+    console.log(`iturri catalog · ${syms.length} symbols · generated ${c.generated}\n`);
+    console.log(syms.join("\n"));
+  } else if (cmd === "bars") {
+    const rows = await bars(args[0], args[1], flags);
+    for (const r of rows.slice(0, Number(flags.limit ?? 20)))
+      console.log(r.timestamp.toISOString().slice(0, 16), r.open, r.high, r.low,
+        r.close, r.volume, r.quality);
+    if (rows.length > 20 && !flags.limit) console.log(`… ${rows.length} rows total (--limit N)`);
+  } else if (cmd === "features") {
+    out(await features(args[0], args[1], flags));
+  } else if (cmd === "bundle") {
+    out(await bundle(args[0]));
+  } else {
+    console.log("usage: iturri <catalog|bars|features|bundle> [args] [--start --end --limit]");
+    process.exit(cmd ? 1 : 0);
+  }
+} catch (e) {
+  console.error(String(e.message ?? e));
+  process.exit(1);
+}

package/index.mjs

@@ -0,0 +1,50 @@
+// iturri — client for the Iturri verified market-data API.
+// Every bar carries a quality flag; filter on it.
+// Data and tooling only — never signals, predictions, or financial advice.
+
+export const BASE_URL = "https://iturri-data.odd-haze-3940.workers.dev";
+export const QUALITY = ["verified", "raw", "reconciled", "interpolated", "disputed", "outage"];
+
+async function get(path, params) {
+  const url = new URL(BASE_URL + path);
+  for (const [k, v] of Object.entries(params ?? {}))
+    if (v !== undefined && v !== null) url.searchParams.set(k, v);
+  const r = await fetch(url);
+  if (!r.ok) throw new Error(`iturri api ${r.status}: ${(await r.json()).error ?? r.statusText}`);
+  return r.json();
+}
+
+/** Full catalog: symbols, timeframes, ranges, pricing, quality legend. Free. */
+export const catalog = () => get("/api/catalog");
+
+/** Quality-flagged OHLCV rows. tf: "1h" | "1d" | "1d_raw" | "1d_split". */
+export async function bars(symbol, tf, { start, end } = {}) {
+  const r = await get("/api/bars", { symbol, tf, start, end });
+  const { t, o, h, l, c, v, q } = r.data;
+  return t.map((ts, i) => ({
+    timestamp: new Date(ts * 1000), open: o[i], high: h[i], low: l[i],
+    close: c[i], volume: v[i], quality: QUALITY[q[i]] ?? "raw",
+  }));
+}
+
+/** Leakage-safe feature matrix rows (19 documented features + regime). */
+export async function features(symbol, tf, { start, end } = {}) {
+  const r = await get("/api/features", { symbol, tf, start, end });
+  const { t, ...cols } = r.data;
+  return t.map((ts, i) => ({
+    timestamp: new Date(ts * 1000),
+    ...Object.fromEntries(Object.entries(cols).map(([k, arr]) => [k, arr[i]])),
+  }));
+}
+
+/** Signed download URLs for a training pack: "crypto" | "equities". */
+export async function bundle(pack) {
+  const r = await fetch(BASE_URL + "/api/bundle", {
+    method: "POST", headers: { "content-type": "application/json" },
+    body: JSON.stringify({ pack }),
+  });
+  if (!r.ok) throw new Error(`iturri api ${r.status}`);
+  const out = await r.json();
+  out.signed_urls = (out.signed_urls ?? []).map((u) => BASE_URL + u);
+  return out;
+}

package/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "iturri",
+  "version": "0.1.0",
+  "description": "Client + CLI for the Iturri verified market-data API — every bar verified or flagged",
+  "type": "module",
+  "main": "index.mjs",
+  "exports": "./index.mjs",
+  "bin": { "iturri": "cli.mjs" },
+  "engines": { "node": ">=18" },
+  "license": "MIT",
+  "files": ["index.mjs", "cli.mjs", "README.md"]
+}