Data sources

Every upstream this project pulls from, one row per source, with its licence terms and the exact attribution line where one is required. See Data for freshness and reachability.

• Coin Metrics Community

  Fetched by

  fetch_coinmetrics.py

  Commercial use

  No - CC BY-NC 4.0 forbids commercial use of the data itself

  Redistribution

  Permitted non-commercially, with attribution

  Attribution

  Some on-chain metrics provided by Coin Metrics Community Network Data, licensed under CC BY-NC 4.0.

  Feeds

  onchain_metrics (MVRV, realized cap, flows, reserve, issuance/Puell), onchain_metrics_multi, BTC daily close backfill (crypto_prices, PriceUSD)

• Yahoo Finance (via yfinance)

  Fetched by

  fetch_mstr.py, fetch_options.py, fetch_btc_ohlc.py, fetch_comparables.py

  Commercial use

  No - Yahoo's terms bar commercial use and redistribution of data obtained outside an official licensed feed; yfinance is an unofficial wrapper, not a licensed API

  Redistribution

  No

  Feeds

  MSTR price/volume, MSTR options context, comparable BTC-treasury universe, BTC daily OHLC (fallback to Coin Metrics PriceUSD for the classifier)

• CoinGecko

  Fetched by

  fetch_coingecko.py, fetch_prices.py, probe_sources.py

  Commercial use

  Free/Demo tier: non-commercial, attribution required; commercial use requires a paid plan

  Redistribution

  Permitted on free tier with attribution; no resale of raw data

  Attribution

  Data provided by CoinGecko.

  Feeds

  market_context (live BTC/ETH/XRP price feed), source probes

• alternative.me (Fear & Greed Index)

  Fetched by

  fetch_sentiment_liquidity.py

  Commercial use

  No formal licence published; publicly offered for free reuse, commonly cited with source attribution

  Redistribution

  Widely reused with attribution; no explicit resale restriction found

  Attribution

  Fear & Greed Index data via alternative.me.

  Feeds

  sentiment_liquidity.fear_greed_value - adjacent signal on the Read (decision 0.2.3, not core)

• DefiLlama (stablecoins)

  Fetched by

  fetch_sentiment_liquidity.py

  Commercial use

  No - Clause 7 limits use to personal, non-commercial use only

  Redistribution

  No - Clause 8 expressly prohibits republishing the data "in any form"

  Feeds

  sentiment_liquidity.stablecoin_supply_usd - lab-only, gated behind GHOST_ALPHA_LAB_MODE (DATA_LICENCES.md)

• mempool.space

  Fetched by

  fetch_network_health.py

  Commercial use

  Permitted; no commercial restriction published on the public API's data

  Redistribution

  Permitted

  Feeds

  network_health

• Kraken (Futures/derivatives public endpoints)

  Fetched by

  fetch_kraken_derivatives.py

  Commercial use

  Public endpoints are for informational use; commercial redistribution as a standalone product is not covered

  Redistribution

  Not intended - public endpoints are for informational/personal use

  Feeds

  derivatives_context (funding rate, open interest) - lab-only, gated behind GHOST_ALPHA_LAB_MODE

• Coinbase Exchange (public market data)

  Fetched by

  fetch_order_book_depth.py

  Commercial use

  Public market-data endpoints are for reference; the user agreement restricts commercial resale/redistribution as a standalone feed

  Redistribution

  No resale of raw book data

  Feeds

  order_book_depth - used to compute MockExchange slippage, not surfaced directly

• Deribit (public API)

  Fetched by

  fetch_deribit_options.py

  Commercial use

  Public API terms permit read access; commercial redistribution of raw data as a product is not covered

  Redistribution

  Not intended for resale

  Feeds

  options_volatility (DVOL, IV term structure, skew) - lab-only, gated behind GHOST_ALPHA_LAB_MODE

• SEC EDGAR

  Fetched by

  fetch_fundamentals.py, fetch_treasury_universe.py, check_capital_stack_filings.py

  Commercial use

  U.S. government work - public domain

  Redistribution

  Permitted, no restriction

  Feeds

  company_fundamentals, treasury-universe comparables, capital-stack filing alerts

• FRED (Federal Reserve Economic Data)

  Fetched by

  fetch_macro.py, fetch_event_calendar.py

  Commercial use

  Most series are public-domain U.S. government data; some series are sourced from third parties and carry the original provider's terms

  Redistribution

  Generally permitted with citation; third-party-sourced series may restrict redistribution

  Attribution

  Source: [series name], Federal Reserve Bank of St. Louis.

  Feeds

  macro_indicators (DXY, real yield, HY spread, gold), event calendar (FOMC/release dates)

• TFTC spot BTC ETF flows

  Fetched by

  fetch_etf_flows.py

  Commercial use

  Yes - CC BY 4.0 permits commercial use

  Redistribution

  Permitted with attribution

  Attribution

  TFTC - tftc.io/bitcoin-etf-flows

  Feeds

  etf_flows, etf_flows_by_fund - flows module input

• Ripple public XRPL server (s2.ripple.com)

  Fetched by

  fetch_rlusd.py

  Commercial use

  No restriction found - the queried data (RLUSD supply) is on a public ledger

  Redistribution

  Permitted

  Feeds

  rlusd_supply (RLUSD supply context; not a classifier input)