Metric methodology

Per metric, the API serves: current value with normalized score and signal (/v1/metrics/{id}), full history with provenance and value_normalized (/v1/metrics/{id}/timeseries), the precomputed variant grid — change variants (absval/abschg/relchg) × time variants (now/past1h..past30d and, where forecasting passed its persistence gate, next24h/next7d/next30d) — at /v1/metrics/{id}/variants, and every computation method's result side by side at /v1/metrics/{id}/methods. Metric IDs are assigned sequentially and carry no meaning; the Type column is the classification: Proprietary = computed by Black Belt Labs and not (easily) available elsewhere — its methodology is a trade secret; Classic = a metric whose substance is available elsewhere, served here with full history, variants and provenance. Rows are anchor-linkable by metric id (e.g. #M50031).

All metrics are computed by the Black Belt Labs engine from raw ingested market data. Quantum-computed metrics run on Qiskit simulators with hardware-ready circuits. Historical values carry a provenance marker: live (computed at the time), backfill_recomputed (same formula re-run on historical data), backfill_approximate (reconstructed from approximate sources), or backfill_model_retro (AI metrics only: model retrodiction under a blind, no-dates protocol — hindsight leakage minimized by construction but not fully excludable), or forecast (a model-projected future value, never an observation).

Forecasts. Selected metrics expose next24h/next7d/next30d variants produced by statistical time-series models retrained weekly. A forecast is published for a metric and horizon only if it beat a naive no-change baseline in out-of-sample backtesting; where it did not, the variant is deliberately absent rather than fabricated. Slow-publication metrics (e.g. attested reserve breakdowns) use the current value as the stated forecast. Realized forecast accuracy is tracked continuously and errors are retained. Forecasts are statistical projections, not predictions of actual outcomes, and are not investment advice.

Computation methods. Per our data doctrine, the same metric may be computed with multiple independent methods — progr (classical/programmatic), learn (AI/machine learning), and quantum (quantum circuits on simulators, hardware-ready). Each computation is stored and labeled separately; the catalog lists every method used per metric and /v1/metrics//methods returns all current computations side by side. Agreement across methods strengthens a signal; divergence is itself information.

Live freshness: status page · pricing · API docs

AI

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10121Regime Transition Probability (7d)ProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50019AI Market NarrativeProprietarylearnAI-Enhanced (Gemini)1hpropublicProprietary methodology — Black Belt Labs trade secret.
M50020AI Anomaly DetectionProprietarylearn, progrAI-Enhanced (Gemini)30minenterprisepublicProprietary methodology — Black Belt Labs trade secret.

Analytics

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50016Regime DetectionProprietarylearn, progrAI-Enhanced (Gemini)30minpropublicProprietary methodology — Black Belt Labs trade secret.

QC

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50021Portfolio OptimizationProprietaryprogr, quantumQuantum Computing (Qiskit) — simulator, hardware-ready1henterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50022Risk Simulation (VaR)Proprietaryprogr, quantumQuantum Computing (Qiskit) — simulator, hardware-ready1henterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50050QC Portfolio OptimizationProprietaryprogr, quantumQuantum Computing (QAOA) — simulator, hardware-readyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50051QC Monte Carlo RiskProprietaryprogr, quantumQuantum Computing (QAE) — simulator, hardware-readyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50052QC Correlation SolverProprietaryprogr, quantumQuantum Computing (Eigensolver) — simulator, hardware-readyenterprisepublicProprietary methodology — Black Belt Labs trade secret.

defi

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10033DeFi Rehypothecation RatioProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50025DeFi TVL MomentumClassicprogrClassical (SQL)basicpublicTotal DeFi TVL in billions USD across tracked protocols; signal from average 24h TVL change.
M50026Protocol Security ScoreClassicprogrClassical (SQL)propublicPercentage of tracked DeFi protocols with positive 24h TVL change.
M50027Smart Contract Risk IndexClassicprogrClassical (SQL)propublicAbsolute average 7-day TVL change across tracked DeFi protocols.

derivatives

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10028Variance Risk PremiumClassicprogrClassical (SQL)dailybasicpublicDeribit DVOL implied volatility minus BBL-computed 30-day realized BTC volatility (annualized, from hourly prices), in volatility points. Positive = options priced rich vs delivered volatility; negative = cheap. The gate for judging whether protective options are worth their premium.
M10037Funding Extremity PercentileClassicprogrClassical (SQL)dailybasicpublicPercentile rank of the current 3-day average BTC perp funding rate within its trailing 2-year distribution. Values near 100 = extremely crowded longs, near 0 = extremely crowded shorts; extremes historically precede mean-reversion (H10054). Computed from Binance BTCUSDT funding history since 2019.
M10111Open Positions (binance)ClassicprogrClassical (SQL)1henterprisepublicTotal BTC+ETH perp open interest on Binance, billions USD (OI x mark price).
M10112Open Positions (okx)ClassicprogrClassical (SQL)1henterprisepublicTotal BTC+ETH perp open interest on OKX, billions USD.
M10113Open Positions (bybit)ClassicprogrClassical (SQL)1henterprisepublicTotal BTC+ETH perp open interest on Bybit, billions USD.
M50006Counterparty Exposure IndexProprietaryprogrClassical (SQL)15minbasicpublicProprietary methodology — Black Belt Labs trade secret.
M50014Funding Rate SentimentClassicprogrClassical (SQL)5minpropublicAverage annualized perpetual funding rate across Binance, OKX and Bybit BTC/ETH perps (8h rate × 3 × 365).
M50015Open Interest RatioClassicprogrClassical (SQL)5minpropublicBTC share of combined BTC+ETH perpetual open interest in USD (Bybit).
M50041Options Put/Call RatioClassicprogrClassical (SQL)propublicTotal put open interest divided by total call open interest on Deribit BTC+ETH options.
M50042Perpetual Premium IndexClassicprogrClassical (SQL)propublicAverage perp basis: (mark - index) / index in percent across tracked perps.

exchange

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10024Shadow Settlement RatioProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50005Exchange Reserve RiskClassicprogrClassical (SQL)15minbasicpublicProxy for exchange reserve drawdown risk from BBL-tracked ETH exchange hot wallets (5 addresses: Binance, Coinbase, Kraken). Cumulative net inflow forms a reserve-level proxy; the metric is its drawdown from the trailing 365-day peak, expressed in days of typical (180-day average) gross flow. Higher = reserves draining faster from their peak; normalized 50 = about 6 days of typical flow withdrawn. Declared proxy: ETH hot wallets only (BTC cold wallets trade too rarely for a flow-normalized level); does not cover full exchange reserves.
M50044Exchange Liquidity DepthClassicprogrClassical (SQL)propublicAverage combined bid+ask depth within ±1% of mid (USD) across tracked order books.

gaming

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50034Gaming Token IndexClassicprogrClassical (SQL)propublic

macro

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10026Carry Exodus PressureClassicprogrClassical (SQL)dailybasicpublic3-month US T-bill yield minus annualized 30-day average BTC perp funding, in percentage points. When the risk-free real dollar out-yields the crypto-native dollar, the structural reason to keep capital inside the stablecoin system erodes - measures when the yield engine of H10022 loses fuel.
M10030Cross-Asset Decoupling ShockProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10038Liquidity Tide IndexProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10041MSTR Relative BidProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10042Weekend Drift DifferentialProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.

market

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50023Altcoin Season IndexClassicprogrClassical (SQL)basicpublicPercentage of top-50 non-stablecoin altcoins outperforming BTC over 30 days.
M50024Market Breadth IndicatorClassicprogrClassical (SQL)basicpublicPercentage of top-100 coins with positive 24h price change.

nft

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50033NFT Market Health IndexClassicprogrClassical (SQL)propublic

onchain

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10025Urgency Asymmetry (currently stale — data source pending)ProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10029Miner Margin SqueezeClassicprogrClassical (SQL)dailybasicpublicMiner economics proxy: BTC price divided by (network difficulty x natural-gas price), indexed to its 2-year average (value 100 = average margin). Normalized score is the inverse percentile - high score = miners squeezed hardest in 2 years, historically a capitulation/bottom antenna. Energy proxied by NG futures; difficulty from the public Bitcoin dataset.
M10032Mining Pool ConcentrationClassicprogrClassical (SQL)dailybasicpublicHerfindahl index of Bitcoin mining-pool block shares over trailing 30 days, from coinbase-tag identification of mined blocks (public blockchain data). Reported alongside the identified share; unidentified blocks are excluded from the index and disclosed. High concentration = fewer independent block producers than the decentralization narrative implies.
M10036Bridge Concentration IndexClassicprogrClassical (SQL)dailybasicpublicHerfindahl index of 30-day flow shares across BBL's tracked L2 bridge contracts (Base, Optimism, zkSync, Polygon), normalized 0 (even) to 100 (single bridge). High concentration = more value exposed to a single bridge's failure - the H10053 blast-radius gauge. Declared fixed four-bridge set.
M10039Sanctioned Wallet ActivityProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10040Halving Cycle PhaseClassicprogrClassical (SQL)dailybasicpublicPosition within the current Bitcoin halving cycle: days elapsed since the last halving as a percentage of the historical inter-halving interval. A pure calendar function (halvings 2012-11-28, 2016-07-09, 2020-05-11, 2024-04-19) - the narrative clock that H10060 says is tradeable despite being fully public.
M10123Exchange Cold Wallet BTC Net Flow (7d)ProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50010Gas Price IndexClassicprogrClassical (SQL)1hbasicpublicAI NLP analysis of regulatory news
M50011Network Congestion ScoreClassicprogrClassical (SQL)1hbasicpublicLatest Ethereum block gas utilization: gas_used / gas_limit, in percent.
M50012Mempool Pressure IndexClassicprogrClassical (SQL)15minpropublicPending transaction count in the Ethereum mempool.
M50013Transaction Volume IndexClassicprogrClassical (SQL)30minbasicpublicTransaction count of the latest sampled Ethereum block.
M50032Smart Contract ActivityClassicprogrClassical (SQL)propublicContract calls as a percentage of transactions in the latest sampled block.
M50037Whale Accumulation IndexClassicprogrClassical (SQL)propublicSum of tracked non-exchange whale wallet balances (ETH).
M50038Exchange Reserve FlowClassicprogrClassical (SQL)propublicSum of tracked exchange wallet balances (ETH); lower is bullish.
M50039Bridge Flow MonitorClassicprogrClassical (SQL)propublic
M50040Smart Contract Activity IndexClassicprogrClassical (SQL)propublic
M50043Exchange Inflow/Outflow RatioClassicprogrClassical (SQL)propublic

regulatory

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10022Announcement Inversion ScoreProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10035Regulatory Tone WhiplashProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50028Regulatory Sentiment IndexProprietaryprogrClassical (SQL)propublicProprietary methodology — Black Belt Labs trade secret.
M50029Compliance Risk ScoreClassicprogrClassical (SQL)propublicAverage GDELT negative-tone score of crypto-regulation news, scaled ×10 (0-100).

sentiment

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50017SentimentClassicprogrClassical (SQL)15minbasicpublicAI NLP sentiment from news and social
M50030Social Sentiment ScoreClassicprogrClassical (SQL)basicpublic
M50031Fear & Greed IndexClassicprogrClassical (SQL)basicpublicPassthrough of the Alternative.me crypto Fear & Greed index (0-100).

social

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10023Degenerate-Canary Divergence (currently stale — data source pending)ProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10027Herding Reflexivity IndexProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.

stablecoin

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50001Stablecoin Health IndexProprietaryprogrClassical (SQL)5minbasicpublicProprietary methodology — Black Belt Labs trade secret.
M50002Tether Printer ActivityClassicprogrClassical (SQL)5minbasicpublicUSDT total supply, in billions.
M50003Stablecoin Dominance RatioClassicprogrClassical (SQL)10minbasicpublicUSDT market cap as a percentage of total tracked stablecoin market cap.
M50004Stablecoin Flow IndicatorProprietaryprogrClassical (SQL)15minbasicpublicProprietary methodology — Black Belt Labs trade secret.
M50035Tether Treasury FlowClassicprogrClassical (SQL)propublicUSDT market cap, in billions USD.
M50036Stablecoin Velocity IndexClassicprogrClassical (SQL)propublicUSDT circulating supply as a percentage of total supply.

tether

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10004USDT Peg DeviationClassicprogrClassical (SQL)1henterprisepublicUSDT market price deviation from 1.000 in percent (internal: CoinGecko price).
M10005USDT Bitfinex PremiumProprietaryprogrClassical (SQL)1henterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10008Tether Gross Printing 24hClassicprogrClassical (SQL)1henterprisepublicChange in USDT total supply over 24h, billions.
M10009Tether Net Printing 24hClassicprogrClassical (SQL)1henterprisepublicChange in USDT circulating supply over 24h, billions.
M10011Tether Published TreasuryClassicprogrClassical (SQL)1henterprisepublicTokens authorized but held in Tether treasury (unissued), billions, from Tether published transparency data.
M10016Inverse-Perp DissonanceProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10019Dollar-Refuge Demand IndexProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10020Peg Suppression IndexProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10021Print-to-Pump DifferentialProprietaryprogrClassical (SQL)dailyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10101Tether Reserves: CashClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10102Tether Reserves: TbillsClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10103Tether Reserves: MetalsClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10104Tether Reserves: BitcoinClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10105Tether Reserves: BondsClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10106Tether Reserves: EquitiesClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10107Tether Reserves: LoansClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10108Tether Reserves: OtherClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10109Tether Reserves: TotalClassicprogrClassical (SQL)1henterprisepublicTether reserves per asset class, billions USD, from Tether published attestation figures.
M10122USDT De-Peg Probability (30d)ProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10124Tether Treasury USDT Net Flow (7d)ProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50053Stablecoin Chatter StressProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.

volatility

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M50018Implied Volatility IndexClassicprogrClassical (SQL)15minbasicpublicDeribit BTC DVOL (annualized implied vol) divided by sqrt(365): daily implied volatility in percent.

volume

IDMetricTypeMethodsComputationCadenceTierPersonalizationMethodology
M10018Volume/Depth Honesty RatioProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M10031Cap-to-Depth Illusion RatioProprietaryprogrClassical (SQL)hourlyenterprisepublicProprietary methodology — Black Belt Labs trade secret.
M50007Volume Authenticity ScoreProprietaryprogrClassical (SQL)30minbasicpublicProprietary methodology — Black Belt Labs trade secret.
M50008Liquidity Fragmentation IndexClassicprogrClassical (SQL)15minbasicpublicCross-venue liquidity fragmentation from BBL orderbook snapshots (Binance, Coinbase, Kraken; BTC and ETH books). Each venue's share of total quoted depth within 2% of mid (bids+asks, latest snapshot per book) feeds a Herfindahl index, normalized so 0 = all depth on one venue and 100 = depth spread evenly across the three tracked venues; averaged over BTC and ETH. Venue set is declared and fixed at three.
M50009Market Depth RatioClassicprogrClassical (SQL)15minpropublicAverage bid-to-ask depth ratio within ±1% of mid across tracked exchange order books (30h window).