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)