finding · findings/evolution/shared_data/scope-expansion-options.md
A ready-made menu for the day we decide to test our research on more coins, more thresholds, or bring back currency markets — the homework is already done, so expanding becomes a one-line decision instead of a fresh investigation.
When the data pool's scope was first locked down (a frozen, written-in-stone definition called the pre-spec — the "S0 pre-registration" of what data we promise to study), two larger versions were also worked out in full and then deliberately set aside. This document preserves that pre-work so that, if we ever want a broader pool, we already know:
EURUSD and used 24 time slices. So treat them as a catalogue for broadening: the forex (currency) rows are the path to reintroduce currencies, and the crypto rows are the path to add coins. The forex pieces are "restore" options, not current scope.A "fetch" or "cell" here means one combination of (symbol × threshold × time-slice) — one tile in the giant grid the probe analyzes. A threshold (measured in dbps, where 1 dbps = 0.001%; e.g. 250 dbps = 0.25%) is how big a price move must be to close one bar and open the next. More symbols, more thresholds, or more time-slices all multiply the number of cells.
Each option is a bigger "test panel." bigblack is the remote GPU server where the data lives. Disk is storage used there; fetch time is roughly how long it takes to gather the cells.
| Option | Crypto symbols | Forex symbols | Total cells | Disk | Fetch time | What it buys you |
|---|---|---|---|---|---|---|
| A — Original minimal DEFAULT | 6 | 1 (EURUSD @ 5 dbps) | 552 | ~2–3 GB | ~12–18 min | Starting baseline; minimal cost; one cross-asset-class anchor present |
| B — Recommended broader | 10 | 3 (EURUSD, GBPUSD, XAGUSD @ 5 dbps) | 960 | ~4–6 GB | ~20–30 min | Adds breadth on the currency side without multi-threshold forex |
| C — Maximalist | 16 | 3 (EURUSD, GBPUSD, XAGUSD × 4 thresholds each) | 1,512 | ~7–12 GB | ~30–50 min | Strongest possible cross-symbol + cross-threshold + cross-asset-class evidence |
"Cross-asset-class" just means: does the finding hold not only across coins but also across a fundamentally different market (currencies/metals)? That's the strongest kind of confirmation a pattern can get.
This is what's locked in the pre-spec. No action needed — it's already in force.
Substrate 1 — Crypto Symbols: BTCUSDT, ETHUSDT, BNBUSDT, LTCUSDT, ADAUSDT, XRPUSDT Thresholds: per-symbol availability (ETH only [100, 250]; others [100, 250, 500, 750]) Slices: 24 Subtotal: 528 cells Substrate 2 — Forex Symbols: EURUSD Thresholds: 5 (single threshold) Slices: 24 Subtotal: 24 cells Grand total: 552 cells, ~2-3 GB, ~12-18 min
A "substrate" is just one slab of the data pool. Note that ETH carries only 2 thresholds while the others carry 4 — that's because each coin only gets the thresholds its real history can reliably support, so cell counts differ per symbol.
Adds 4 crypto symbols and 2 forex symbols. Multi-threshold forex is still not included. Every added coin was checked to have started trading early enough (before 2020-04-01) to fill all the time-slices cleanly.
| Added symbol | Thresholds (dbps) | First usable | Cells added |
|---|---|---|---|
DOGEUSDT | 100, 250, 500, 750 | listed 2019-07-05 | 4 × 24 = 96 |
BCHUSDT | 100, 250, 500, 750 | effective_start 2019-11-28 | 4 × 24 = 96 |
LINKUSDT | 100, 250, 500, 750 | listed 2019-01-16 | 4 × 24 = 96 |
XLMUSDT | 250, 500, 750 | effective_start 2018-05-31 | 3 × 24 = 72 |
GBPUSD (forex) | 5 | full 24-slice coverage | 24 |
XAGUSD (forex/silver) | 5 | full 24-slice coverage | 24 |
Crypto goes from 528 to 888 cells (+360), forex from 24 to 72 cells (+48), for a grand total of 960 cells, ~4–6 GB, ~20–30 min.
When to use Option B:
Adds 6 more crypto symbols on top of B and turns on multi-threshold forex (testing currencies at four breakout sizes, not just one).
BTCUSD_PERP conflicts with policy. One symbol on the maximalist list, BTCUSD_PERP, is a perpetual-futures contract. That contradicts the project's Spot-Only Data Source Policy (root CLAUDE.md Principle 8: "All Binance data uses spot market exclusively. No futures.") — spot means buying the actual asset, futures is a derivative bet on its future price, and the two form prices differently. It's listed here only because it sits in symbols.toml with full history. Before Option C is ever used, BTCUSD_PERP must either be (a) dropped from this list to honor the spot-only rule, or (b) explicitly exempted by the policy owner. Tracked as a CONCEDE-FOLLOW-UP item from the PR #501 adversarial review.Crypto cell math (each cell = thresholds × 24 slices):
| Group | Math | Cells |
|---|---|---|
| BTCUSDT, BNBUSDT, LTCUSDT, ADAUSDT, XRPUSDT | 5 symbols × 4 thresholds × 24 | 480 |
| ETHUSDT | 1 symbol × 2 thresholds × 24 | 48 |
| DOGEUSDT, BCHUSDT, LINKUSDT | 3 symbols × 4 thresholds × 24 | 288 |
| XLMUSDT, ETCUSDT, BTCUSD_PERP | 3 symbols × 3 thresholds × 24 | 216 |
| ATOMUSDT, TRXUSDT, ZECUSDT, HBARUSDT | 4 symbols × 2 thresholds × 24 | 192 |
| Total crypto | 480 + 48 + 288 + 216 + 192 | 1,224 |
Forex cell math (3 currency/metal pairs × 4 thresholds × 24 slices):
EURUSD [5, 10, 25, 50] × 24 = 96 GBPUSD [5, 10, 25, 50] × 24 = 96 XAGUSD [5, 10, 25, 50] × 24 = 96 Total forex: 288
Grand total: 1,224 + 288 = 1,512 cells, ~7–12 GB on bigblack, ~30–45 min.
When to use Option C:
Some symbols were considered and explicitly excluded from all three options — mostly because they have thin or partial history that would make results noisy or messy.
| Not included | Why |
|---|---|
| Partial-coverage crypto (SOL, AVAX, DOT, …) | 21–22 slices instead of 24; complicates the manifest. The 16 full-coverage coins already give enough symbol diversity. |
| Post-2023 listings (SUI, WLD, PEPE, WIF, TON) | <12 slices each; too little history makes verdicts noisy. |
| XAUUSD (gold) | Listed 2023-08-30 — only ~10 of 24 slices covered. |
| EURUSD at 1, 2, 3 dbps | Extreme high-resolution thresholds; doubles EUR/USD storage for marginal extra information. |
| BTCUSD_FUT (futures pairs other than PERP) | Different price-formation mechanism; not in the current data pipeline. |
| Other forex pairs (USDJPY, AUDUSD, USDCHF) | Not present in the current fxview_cache.forex_bars store (per the 2026-05-23 probe); adding them needs pipeline expansion. |
If any of these ever become relevant, they get their own Option D / E / F analysis added to the same document, in the same format.
An important design detail: the current model has no fetcher and no manifest. The probe reads each cell live from ClickHouse (the database, running read-only on bigblack) at run time. That makes broadening the scope refreshingly mechanical:
pre-spec.md: add a changelog row and update the symbol × threshold matrix (re-add a forex section if reintroducing currencies).orthogonality_probe.py — SYMBOL_THRESHOLDS, MIN_YEAR / SLICES, THRESHOLD_TIERS. Heads-up: reintroducing forex is new code, not just a constant flip — you'd add a second data path (fxview_cache.forex_bars FINAL plus the column set from the archived forex-availability-probe.md), because the probe is crypto-only today.There's also no "downgrade" needed: the scope is simply whatever the probe's constants say at run time, so narrowing is just a constant edit.
Every pre-spec version carries a content hash (a short fingerprint of its exact text). That lets any future result cite precisely which scope it ran against — so reviewers can tell what was and wasn't covered.
"computed on shared_data pre-spec-v1 (hash abc123) covering 552 cells"
"computed on shared_data pre-spec-v2 (hash def456) covering 960 cells, of which 552 inherit from v1"
This gives clean provenance for both metric and feature audits. (The fetch-time version bookkeeping described in the source was for the now-removed parquet model and no longer applies under the live-read model.)
A (default): 6 crypto + EURUSD @ 5 = 552 cells B (broader): 10 crypto + 3 forex @ 5 = 960 cells C (max): 16 crypto + 3 forex × 4 thresholds = 1,512 cells
A: BTC ETH BNB LTC ADA XRP | EURUSD@5 B: + DOGE BCH LINK XLM | + GBPUSD XAGUSD @5 C: + ATOM TRX ZEC HBAR ETC BTCUSD_PERP | + multi-threshold [5,10,25,50] on all 3 forex