brk-client 0.3.0-beta.2 → 0.3.0-beta.4

package/index.js

@@ -314,8 +314,8 @@ Matches mempool.space/bitcoin-cli behavior.
  */
 /**
  * Raw cents squared (u128) - stores cents² × sats without division.
- * Used for precise accumulation of investor cap values: Σ(price² × sats).
- * investor_price = investor_cap_raw / realized_cap_raw
+ * Used for precise accumulation of capitalized cap values: Σ(price² × sats).
+ * capitalized_price = capitalized_cap_raw / realized_cap_raw
  *
  * @typedef {number} CentsSquaredSats
  */
@@ -325,9 +325,9 @@ Matches mempool.space/bitcoin-cli behavior.
  * @typedef {Dollars} Close
  */
 /**
- * Cohort identifier for cost basis distribution.
+ * URPD cohort identifier. Use `GET /api/urpd` to list available cohorts.
  *
- * @typedef {string} Cohort
+ * @typedef {("all"|"sth"|"lth"|"utxos_under_1h_old"|"utxos_1h_to_1d_old"|"utxos_1d_to_1w_old"|"utxos_1w_to_1m_old"|"utxos_1m_to_2m_old"|"utxos_2m_to_3m_old"|"utxos_3m_to_4m_old"|"utxos_4m_to_5m_old"|"utxos_5m_to_6m_old"|"utxos_6m_to_1y_old"|"utxos_1y_to_2y_old"|"utxos_2y_to_3y_old"|"utxos_3y_to_4y_old"|"utxos_4y_to_5y_old"|"utxos_5y_to_6y_old"|"utxos_6y_to_7y_old"|"utxos_7y_to_8y_old"|"utxos_8y_to_10y_old"|"utxos_10y_to_12y_old"|"utxos_12y_to_15y_old"|"utxos_over_15y_old")} Cohort
  */
 /**
  * Coinbase scriptSig tag for pool identification.
@@ -341,35 +341,21 @@ Matches mempool.space/bitcoin-cli behavior.
  * @typedef {string} CoinbaseTag
  */
 /**
- * Bucket type for cost basis aggregation.
- * Options: raw (no aggregation), lin200/lin500/lin1000 (linear $200/$500/$1000),
- * log10/log50/log100/log200 (logarithmic with 10/50/100/200 buckets per decade).
- *
- * @typedef {("raw"|"lin200"|"lin500"|"lin1000"|"log10"|"log50"|"log100"|"log200")} CostBasisBucket
- */
-/**
- * Path parameters for cost basis dates endpoint.
- *
  * @typedef {Object} CostBasisCohortParam
  * @property {Cohort} cohort
  */
 /**
- * Path parameters for cost basis distribution endpoint.
- *
  * @typedef {Object} CostBasisParams
  * @property {Cohort} cohort
  * @property {string} date
  */
 /**
- * Query parameters for cost basis distribution endpoint.
- *
  * @typedef {Object} CostBasisQuery
- * @property {CostBasisBucket=} bucket - Bucket type for aggregation. Default: raw (no aggregation).
- * @property {CostBasisValue=} value - Value type to return. Default: supply.
+ * @property {UrpdAggregation=} bucket
+ * @property {CostBasisValue=} value
  */
 /**
- * Value type for cost basis distribution.
- * Options: supply (BTC), realized (USD, price × supply), unrealized (USD, spot × supply).
+ * Value type for the deprecated cost-basis distribution output.
  *
  * @typedef {("supply"|"realized"|"unrealized")} CostBasisValue
  */
@@ -516,7 +502,7 @@ Matches mempool.space/bitcoin-cli behavior.
  * @property {Sats} received - Satoshis received by this address
  * @property {Sats} sent - Satoshis sent by this address
  * @property {CentsSats} realizedCapRaw - The realized capitalization: Σ(price × sats)
- * @property {CentsSquaredSats} investorCapRaw - The investor capitalization: Σ(price² × sats)
+ * @property {CentsSquaredSats} capitalizedCapRaw - The capitalized cap: Σ(price² × sats)
  */
 /** @typedef {TypeIndex} FundedAddrIndex */
 /** @typedef {number} Halving */
@@ -626,7 +612,7 @@ Matches mempool.space/bitcoin-cli behavior.
  * Block info in a mempool.space like format for fee estimation.
  *
  * @typedef {Object} MempoolBlock
- * @property {number} blockSize - Total block size in weight units
+ * @property {number} blockSize - Total serialized block size in bytes (witness + non-witness).
  * @property {number} blockVSize - Total block virtual size in vbytes
  * @property {number} nTx - Number of transactions in the projected block
  * @property {Sats} totalFees - Total fees in satoshis
@@ -1159,6 +1145,58 @@ Matches mempool.space/bitcoin-cli behavior.
 /** @typedef {number[]} U8x33 */
 /** @typedef {number[]} U8x65 */
 /** @typedef {TypeIndex} UnknownOutputIndex */
+/**
+ * UTXO Realized Price Distribution for a cohort on a specific date.
+ *
+ * Supply is grouped by the close price at which each UTXO was last moved.
+ * Each bucket exposes three values derived from the same `(price_floor, supply)`
+ * pairs: supply in BTC, realized cap contribution in USD (`price_floor * supply`),
+ * and unrealized P&L against that date's close in USD
+ * (`(close - price_floor) * supply`, can be negative).
+ *
+ * @typedef {Object} Urpd
+ * @property {Cohort} cohort
+ * @property {Date} date
+ * @property {UrpdAggregation} aggregation - Aggregation strategy applied to the buckets.
+ * @property {Dollars} close - Close price on `date`, in USD. Anchor for `unrealized_pnl`.
+ * @property {Bitcoin} totalSupply - Sum of `supply` across all buckets, in BTC.
+ * @property {UrpdBucket[]} buckets
+ */
+/**
+ * Aggregation strategy for URPD buckets.
+ * Options: raw (no aggregation), lin200/lin500/lin1000 (linear $200/$500/$1000),
+ * log10/log50/log100/log200 (logarithmic with 10/50/100/200 buckets per decade).
+ *
+ * @typedef {("raw"|"lin200"|"lin500"|"lin1000"|"log10"|"log50"|"log100"|"log200")} UrpdAggregation
+ */
+/**
+ * A single bucket in a URPD snapshot.
+ *
+ * @typedef {Object} UrpdBucket
+ * @property {Dollars} priceFloor - Inclusive lower bound of the bucket, in USD.
+ * @property {Bitcoin} supply - Supply held with a last-move price inside this bucket, in BTC.
+ * @property {Dollars} realizedCap - Realized cap contribution in USD: `price_floor * supply`.
+ * @property {Dollars} unrealizedPnl - Unrealized P&L in USD against the close on the snapshot date: `(close - price_floor) * supply`. Can be negative.
+ */
+/**
+ * Path parameters for per-cohort URPD endpoints.
+ *
+ * @typedef {Object} UrpdCohortParam
+ * @property {Cohort} cohort
+ */
+/**
+ * Path parameters for `/api/urpd/{cohort}/{date}`.
+ *
+ * @typedef {Object} UrpdParams
+ * @property {Cohort} cohort
+ * @property {string} date
+ */
+/**
+ * Query parameters for URPD endpoints.
+ *
+ * @typedef {Object} UrpdQuery
+ * @property {UrpdAggregation=} agg - Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
+ */
 /**
  * Unspent transaction output
  *
@@ -2098,10 +2136,10 @@ function create_10y1m1w1y2y3m3y4y5y6m6y8yPattern3(client, acc) {
  */
 
 /**
- * @typedef {Object} CapGrossInvestorLossMvrvNetPeakPriceProfitSellSoprPattern
+ * @typedef {Object} CapCapitalizedGrossLossMvrvNetPeakPriceProfitSellSoprPattern
  * @property {CentsDeltaToUsdPattern} cap
+ * @property {PricePattern} capitalized
  * @property {BlockCumulativeSumPattern} grossPnl
- * @property {PricePattern} investor
  * @property {BlockCumulativeNegativeSumPattern} loss
  * @property {SeriesPattern1<StoredF32>} mvrv
  * @property {BlockChangeCumulativeDeltaSumPattern} netPnl
@@ -2109,7 +2147,7 @@ function create_10y1m1w1y2y3m3y4y5y6m6y8yPattern3(client, acc) {
  * @property {BpsCentsPercentilesRatioSatsSmaStdUsdPattern} price
  * @property {BlockCumulativeSumPattern} profit
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
- * @property {_1m1w1y24hPattern7} sellSideRiskRatio
+ * @property {_1m1w1y24hPattern8} sellSideRiskRatio
  * @property {AdjustedRatioValuePattern} sopr
  */
 
@@ -2301,7 +2339,7 @@ function createIndexPct0Pct1Pct2Pct5Pct95Pct98Pct99ScorePattern(client, acc) {
 }
 
 /**
- * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5
+ * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6
  * @property {AverageBlockCumulativeSumPattern<StoredU64>} all
  * @property {AverageBlockCumulativeSumPattern<StoredU64>} p2a
  * @property {AverageBlockCumulativeSumPattern<StoredU64>} p2pk33
@@ -2314,12 +2352,12 @@ function createIndexPct0Pct1Pct2Pct5Pct95Pct98Pct99ScorePattern(client, acc) {
  */
 
 /**
- * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5 pattern node
+ * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5}
+ * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6}
  */
-function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(client, acc) {
+function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(client, acc) {
   return {
     all: createAverageBlockCumulativeSumPattern(client, acc),
     p2a: createAverageBlockCumulativeSumPattern(client, _p('p2a', acc)),
@@ -2334,7 +2372,7 @@ function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(client, acc) {
 }
 
 /**
- * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3
+ * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4
  * @property {SeriesPattern1<StoredU64>} all
  * @property {SeriesPattern1<StoredU64>} p2a
  * @property {SeriesPattern1<StoredU64>} p2pk33
@@ -2347,12 +2385,12 @@ function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(client, acc) {
  */
 
 /**
- * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3 pattern node
+ * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3}
+ * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4}
  */
-function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(client, acc) {
+function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4(client, acc) {
   return {
     all: createSeriesPattern1(client, acc),
     p2a: createSeriesPattern1(client, _p('p2a', acc)),
@@ -2367,7 +2405,7 @@ function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(client, acc) {
 }
 
 /**
- * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6
+ * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7
  * @property {_1m1w1y24hBpsPercentRatioPattern} all
  * @property {_1m1w1y24hBpsPercentRatioPattern} p2a
  * @property {_1m1w1y24hBpsPercentRatioPattern} p2pk33
@@ -2380,12 +2418,12 @@ function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(client, acc) {
  */
 
 /**
- * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6 pattern node
+ * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6}
+ * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7}
  */
-function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(client, acc) {
+function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7(client, acc) {
   return {
     all: create_1m1w1y24hBpsPercentRatioPattern(client, acc),
     p2a: create_1m1w1y24hBpsPercentRatioPattern(client, _p('p2a', acc)),
@@ -2433,11 +2471,11 @@ function createAverageMaxMedianMinPct10Pct25Pct75Pct90SumPattern(client, acc) {
 }
 
 /**
- * @typedef {Object} GrossInvestedInvestorLossNetNuplProfitSentimentPattern2
+ * @typedef {Object} CapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2
+ * @property {SeriesPattern18<CentsSquaredSats>} capitalizedCapInLossRaw
+ * @property {SeriesPattern18<CentsSquaredSats>} capitalizedCapInProfitRaw
  * @property {CentsUsdPattern3} grossPnl
- * @property {InPattern} investedCapital
- * @property {SeriesPattern18<CentsSquaredSats>} investorCapInLossRaw
- * @property {SeriesPattern18<CentsSquaredSats>} investorCapInProfitRaw
+ * @property {InPattern2} investedCapital
  * @property {CentsNegativeToUsdPattern2} loss
  * @property {CentsToUsdPattern3} netPnl
  * @property {BpsRatioPattern} nupl
@@ -2446,17 +2484,17 @@ function createAverageMaxMedianMinPct10Pct25Pct75Pct90SumPattern(client, acc) {
  */
 
 /**
- * Create a GrossInvestedInvestorLossNetNuplProfitSentimentPattern2 pattern node
+ * Create a CapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {GrossInvestedInvestorLossNetNuplProfitSentimentPattern2}
+ * @returns {CapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2}
  */
-function createGrossInvestedInvestorLossNetNuplProfitSentimentPattern2(client, acc) {
+function createCapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2(client, acc) {
   return {
+    capitalizedCapInLossRaw: createSeriesPattern18(client, _m(acc, 'capitalized_cap_in_loss_raw')),
+    capitalizedCapInProfitRaw: createSeriesPattern18(client, _m(acc, 'capitalized_cap_in_profit_raw')),
     grossPnl: createCentsUsdPattern3(client, _m(acc, 'unrealized_gross_pnl')),
-    investedCapital: createInPattern(client, _m(acc, 'invested_capital_in')),
-    investorCapInLossRaw: createSeriesPattern18(client, _m(acc, 'investor_cap_in_loss_raw')),
-    investorCapInProfitRaw: createSeriesPattern18(client, _m(acc, 'investor_cap_in_profit_raw')),
+    investedCapital: createInPattern2(client, _m(acc, 'invested_capital_in')),
     loss: createCentsNegativeToUsdPattern2(client, _m(acc, 'unrealized_loss')),
     netPnl: createCentsToUsdPattern3(client, _m(acc, 'net_unrealized_pnl')),
     nupl: createBpsRatioPattern(client, _m(acc, 'nupl')),
@@ -2717,7 +2755,7 @@ function create_1m1w1y2y4yAllPattern(client, acc) {
  * @property {BaseDeltaPattern} addrCount
  * @property {SpendingSpentUnspentPattern} outputs
  * @property {CapLossMvrvPriceProfitPattern} realized
- * @property {DeltaTotalPattern} supply
+ * @property {DeltaDominanceTotalPattern} supply
  * @property {NuplPattern} unrealized
  */
 
@@ -2733,7 +2771,7 @@ function createActivityAddrOutputsRealizedSupplyUnrealizedPattern(client, acc) {
     addrCount: createBaseDeltaPattern(client, _m(acc, 'addr_count')),
     outputs: createSpendingSpentUnspentPattern(client, acc),
     realized: createCapLossMvrvPriceProfitPattern(client, acc),
-    supply: createDeltaTotalPattern(client, _m(acc, 'supply')),
+    supply: createDeltaDominanceTotalPattern(client, _m(acc, 'supply')),
     unrealized: createNuplPattern(client, _m(acc, 'nupl')),
   };
 }
@@ -2792,33 +2830,6 @@ function createBpsCentsPercentilesRatioSatsUsdPattern(client, acc) {
   };
 }
 
-/**
- * @typedef {Object} BtcCentsSatsToUsdPattern3
- * @property {SeriesPattern1<Bitcoin>} btc
- * @property {SeriesPattern1<Cents>} cents
- * @property {SeriesPattern1<Sats>} sats
- * @property {BpsPercentRatioPattern2} toCirculating
- * @property {BpsPercentRatioPattern2} toOwn
- * @property {SeriesPattern1<Dollars>} usd
- */
-
-/**
- * Create a BtcCentsSatsToUsdPattern3 pattern node
- * @param {BrkClientBase} client
- * @param {string} acc - Accumulated series name
- * @returns {BtcCentsSatsToUsdPattern3}
- */
-function createBtcCentsSatsToUsdPattern3(client, acc) {
-  return {
-    btc: createSeriesPattern1(client, acc),
-    cents: createSeriesPattern1(client, _m(acc, 'cents')),
-    sats: createSeriesPattern1(client, _m(acc, 'sats')),
-    toCirculating: createBpsPercentRatioPattern2(client, _m(acc, 'to_circulating')),
-    toOwn: createBpsPercentRatioPattern2(client, _m(acc, 'to_own')),
-    usd: createSeriesPattern1(client, _m(acc, 'usd')),
-  };
-}
-
 /**
  * @typedef {Object} CentsNegativeToUsdPattern2
  * @property {SeriesPattern1<Cents>} cents
@@ -2847,55 +2858,55 @@ function createCentsNegativeToUsdPattern2(client, acc) {
 }
 
 /**
- * @typedef {Object} DeltaHalfInToTotalPattern
- * @property {AbsoluteRatePattern} delta
+ * @typedef {Object} DeltaDominanceHalfInTotalPattern2
+ * @property {AbsoluteRatePattern3} delta
+ * @property {BpsPercentRatioPattern2} dominance
  * @property {BtcCentsSatsUsdPattern} half
- * @property {BtcCentsSatsToUsdPattern} inLoss
- * @property {BtcCentsSatsToUsdPattern} inProfit
- * @property {BpsPercentRatioPattern2} toCirculating
+ * @property {BtcCentsSatsShareUsdPattern} inLoss
+ * @property {BtcCentsSatsShareUsdPattern} inProfit
  * @property {BtcCentsSatsUsdPattern} total
  */
 
 /**
- * Create a DeltaHalfInToTotalPattern pattern node
+ * Create a DeltaDominanceHalfInTotalPattern2 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {DeltaHalfInToTotalPattern}
+ * @returns {DeltaDominanceHalfInTotalPattern2}
  */
-function createDeltaHalfInToTotalPattern(client, acc) {
+function createDeltaDominanceHalfInTotalPattern2(client, acc) {
   return {
-    delta: createAbsoluteRatePattern(client, _m(acc, 'delta')),
+    delta: createAbsoluteRatePattern3(client, _m(acc, 'delta')),
+    dominance: createBpsPercentRatioPattern2(client, _m(acc, 'dominance')),
     half: createBtcCentsSatsUsdPattern(client, _m(acc, 'half')),
-    inLoss: createBtcCentsSatsToUsdPattern(client, _m(acc, 'in_loss')),
-    inProfit: createBtcCentsSatsToUsdPattern(client, _m(acc, 'in_profit')),
-    toCirculating: createBpsPercentRatioPattern2(client, _m(acc, 'to_circulating')),
+    inLoss: createBtcCentsSatsShareUsdPattern(client, _m(acc, 'in_loss')),
+    inProfit: createBtcCentsSatsShareUsdPattern(client, _m(acc, 'in_profit')),
     total: createBtcCentsSatsUsdPattern(client, acc),
   };
 }
 
 /**
- * @typedef {Object} DeltaHalfInToTotalPattern2
- * @property {AbsoluteRatePattern} delta
+ * @typedef {Object} DeltaDominanceHalfInTotalPattern
+ * @property {AbsoluteRatePattern3} delta
+ * @property {BpsPercentRatioPattern2} dominance
  * @property {BtcCentsSatsUsdPattern} half
- * @property {BtcCentsSatsToUsdPattern3} inLoss
- * @property {BtcCentsSatsToUsdPattern3} inProfit
- * @property {BpsPercentRatioPattern2} toCirculating
+ * @property {BtcCentsSatsUsdPattern} inLoss
+ * @property {BtcCentsSatsUsdPattern} inProfit
  * @property {BtcCentsSatsUsdPattern} total
  */
 
 /**
- * Create a DeltaHalfInToTotalPattern2 pattern node
+ * Create a DeltaDominanceHalfInTotalPattern pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {DeltaHalfInToTotalPattern2}
+ * @returns {DeltaDominanceHalfInTotalPattern}
  */
-function createDeltaHalfInToTotalPattern2(client, acc) {
+function createDeltaDominanceHalfInTotalPattern(client, acc) {
   return {
-    delta: createAbsoluteRatePattern(client, _m(acc, 'delta')),
+    delta: createAbsoluteRatePattern3(client, _m(acc, 'delta')),
+    dominance: createBpsPercentRatioPattern2(client, _m(acc, 'dominance')),
     half: createBtcCentsSatsUsdPattern(client, _m(acc, 'half')),
-    inLoss: createBtcCentsSatsToUsdPattern3(client, _m(acc, 'in_loss')),
-    inProfit: createBtcCentsSatsToUsdPattern3(client, _m(acc, 'in_profit')),
-    toCirculating: createBpsPercentRatioPattern2(client, _m(acc, 'to_circulating')),
+    inLoss: createBtcCentsSatsUsdPattern(client, _m(acc, 'in_loss')),
+    inProfit: createBtcCentsSatsUsdPattern(client, _m(acc, 'in_profit')),
     total: createBtcCentsSatsUsdPattern(client, acc),
   };
 }
@@ -2955,7 +2966,7 @@ function createActiveBidirectionalReactivatedReceivingSendingPattern(client, acc
  * @property {CoindaysTransferPattern} activity
  * @property {SpendingSpentUnspentPattern} outputs
  * @property {CapLossMvrvNetPriceProfitSoprPattern} realized
- * @property {DeltaHalfInToTotalPattern} supply
+ * @property {DeltaDominanceHalfInTotalPattern} supply
  * @property {LossNetNuplProfitPattern} unrealized
  */
 
@@ -2970,7 +2981,7 @@ function createActivityOutputsRealizedSupplyUnrealizedPattern(client, acc) {
     activity: createCoindaysTransferPattern(client, acc),
     outputs: createSpendingSpentUnspentPattern(client, acc),
     realized: createCapLossMvrvNetPriceProfitSoprPattern(client, acc),
-    supply: createDeltaHalfInToTotalPattern(client, _m(acc, 'supply')),
+    supply: createDeltaDominanceHalfInTotalPattern(client, _m(acc, 'supply')),
     unrealized: createLossNetNuplProfitPattern(client, acc),
   };
 }
@@ -2980,7 +2991,7 @@ function createActivityOutputsRealizedSupplyUnrealizedPattern(client, acc) {
  * @property {TransferPattern} activity
  * @property {SpendingSpentUnspentPattern} outputs
  * @property {CapLossMvrvPriceProfitPattern} realized
- * @property {DeltaHalfInTotalPattern2} supply
+ * @property {DeltaDominanceHalfInTotalPattern} supply
  * @property {LossNuplProfitPattern} unrealized
  */
 
@@ -2995,7 +3006,7 @@ function createActivityOutputsRealizedSupplyUnrealizedPattern3(client, acc) {
     activity: createTransferPattern(client, _m(acc, 'transfer_volume')),
     outputs: createSpendingSpentUnspentPattern(client, acc),
     realized: createCapLossMvrvPriceProfitPattern(client, acc),
-    supply: createDeltaHalfInTotalPattern2(client, _m(acc, 'supply')),
+    supply: createDeltaDominanceHalfInTotalPattern(client, _m(acc, 'supply')),
     unrealized: createLossNuplProfitPattern(client, acc),
   };
 }
@@ -3005,7 +3016,7 @@ function createActivityOutputsRealizedSupplyUnrealizedPattern3(client, acc) {
  * @property {TransferPattern} activity
  * @property {SpendingSpentUnspentPattern} outputs
  * @property {CapLossMvrvPriceProfitPattern} realized
- * @property {DeltaTotalPattern} supply
+ * @property {DeltaDominanceTotalPattern} supply
  * @property {NuplPattern} unrealized
  */
 
@@ -3020,7 +3031,7 @@ function createActivityOutputsRealizedSupplyUnrealizedPattern2(client, acc) {
     activity: createTransferPattern(client, _m(acc, 'transfer_volume')),
     outputs: createSpendingSpentUnspentPattern(client, acc),
     realized: createCapLossMvrvPriceProfitPattern(client, acc),
-    supply: createDeltaTotalPattern(client, _m(acc, 'supply')),
+    supply: createDeltaDominanceTotalPattern(client, _m(acc, 'supply')),
     unrealized: createNuplPattern(client, _m(acc, 'nupl')),
   };
 }
@@ -3079,7 +3090,7 @@ function createBpsCentsRatioSatsUsdPattern(client, acc) {
  * @typedef {Object} BtcCentsDeltaSatsUsdPattern
  * @property {SeriesPattern1<Bitcoin>} btc
  * @property {SeriesPattern1<Cents>} cents
- * @property {AbsoluteRatePattern} delta
+ * @property {AbsoluteRatePattern3} delta
  * @property {SeriesPattern1<Sats>} sats
  * @property {SeriesPattern1<Dollars>} usd
  */
@@ -3094,58 +3105,33 @@ function createBtcCentsDeltaSatsUsdPattern(client, acc) {
   return {
     btc: createSeriesPattern1(client, acc),
     cents: createSeriesPattern1(client, _m(acc, 'cents')),
-    delta: createAbsoluteRatePattern(client, _m(acc, 'delta')),
+    delta: createAbsoluteRatePattern3(client, _m(acc, 'delta')),
     sats: createSeriesPattern1(client, _m(acc, 'sats')),
     usd: createSeriesPattern1(client, _m(acc, 'usd')),
   };
 }
 
 /**
- * @typedef {Object} BtcCentsSatsToUsdPattern
+ * @typedef {Object} BtcCentsSatsShareUsdPattern
  * @property {SeriesPattern1<Bitcoin>} btc
  * @property {SeriesPattern1<Cents>} cents
  * @property {SeriesPattern1<Sats>} sats
- * @property {BpsPercentRatioPattern2} toCirculating
+ * @property {BpsPercentRatioPattern2} share
  * @property {SeriesPattern1<Dollars>} usd
  */
 
 /**
- * Create a BtcCentsSatsToUsdPattern pattern node
+ * Create a BtcCentsSatsShareUsdPattern pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {BtcCentsSatsToUsdPattern}
+ * @returns {BtcCentsSatsShareUsdPattern}
  */
-function createBtcCentsSatsToUsdPattern(client, acc) {
+function createBtcCentsSatsShareUsdPattern(client, acc) {
   return {
     btc: createSeriesPattern1(client, acc),
     cents: createSeriesPattern1(client, _m(acc, 'cents')),
     sats: createSeriesPattern1(client, _m(acc, 'sats')),
-    toCirculating: createBpsPercentRatioPattern2(client, _m(acc, 'to_circulating')),
-    usd: createSeriesPattern1(client, _m(acc, 'usd')),
-  };
-}
-
-/**
- * @typedef {Object} BtcCentsSatsToUsdPattern2
- * @property {SeriesPattern1<Bitcoin>} btc
- * @property {SeriesPattern1<Cents>} cents
- * @property {SeriesPattern1<Sats>} sats
- * @property {BpsPercentRatioPattern2} toOwn
- * @property {SeriesPattern1<Dollars>} usd
- */
-
-/**
- * Create a BtcCentsSatsToUsdPattern2 pattern node
- * @param {BrkClientBase} client
- * @param {string} acc - Accumulated series name
- * @returns {BtcCentsSatsToUsdPattern2}
- */
-function createBtcCentsSatsToUsdPattern2(client, acc) {
-  return {
-    btc: createSeriesPattern1(client, acc),
-    cents: createSeriesPattern1(client, _m(acc, 'cents')),
-    sats: createSeriesPattern1(client, _m(acc, 'sats')),
-    toOwn: createBpsPercentRatioPattern2(client, _m(acc, 'to_own')),
+    share: createBpsPercentRatioPattern2(client, _m(acc, 'share')),
     usd: createSeriesPattern1(client, _m(acc, 'usd')),
   };
 }
@@ -3200,31 +3186,6 @@ function createCentsToUsdPattern4(client, acc) {
   };
 }
 
-/**
- * @typedef {Object} DeltaHalfInTotalPattern2
- * @property {AbsoluteRatePattern} delta
- * @property {BtcCentsSatsUsdPattern} half
- * @property {BtcCentsSatsUsdPattern} inLoss
- * @property {BtcCentsSatsUsdPattern} inProfit
- * @property {BtcCentsSatsUsdPattern} total
- */
-
-/**
- * Create a DeltaHalfInTotalPattern2 pattern node
- * @param {BrkClientBase} client
- * @param {string} acc - Accumulated series name
- * @returns {DeltaHalfInTotalPattern2}
- */
-function createDeltaHalfInTotalPattern2(client, acc) {
-  return {
-    delta: createAbsoluteRatePattern(client, _m(acc, 'delta')),
-    half: createBtcCentsSatsUsdPattern(client, _m(acc, 'half')),
-    inLoss: createBtcCentsSatsUsdPattern(client, _m(acc, 'in_loss')),
-    inProfit: createBtcCentsSatsUsdPattern(client, _m(acc, 'in_profit')),
-    total: createBtcCentsSatsUsdPattern(client, acc),
-  };
-}
-
 /**
  * @typedef {Object} EmaHistogramLineSignalPattern
  * @property {SeriesPattern1<StoredF32>} emaFast
@@ -3283,7 +3244,7 @@ function create_1m1w1y24hPattern2(client, acc) {
 }
 
 /**
- * @typedef {Object} _1m1w1y24hPattern7
+ * @typedef {Object} _1m1w1y24hPattern8
  * @property {BpsPercentRatioPattern4} _1m
  * @property {BpsPercentRatioPattern4} _1w
  * @property {BpsPercentRatioPattern4} _1y
@@ -3291,12 +3252,12 @@ function create_1m1w1y24hPattern2(client, acc) {
  */
 
 /**
- * Create a _1m1w1y24hPattern7 pattern node
+ * Create a _1m1w1y24hPattern8 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {_1m1w1y24hPattern7}
+ * @returns {_1m1w1y24hPattern8}
  */
-function create_1m1w1y24hPattern7(client, acc) {
+function create_1m1w1y24hPattern8(client, acc) {
   return {
     _1m: createBpsPercentRatioPattern4(client, _m(acc, '1m')),
     _1w: createBpsPercentRatioPattern4(client, _m(acc, '1w')),
@@ -3351,6 +3312,29 @@ function create_1m1w1y24hPattern3(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} _1m1w1y24hPattern7
+ * @property {BtcSatsPattern} _1m
+ * @property {BtcSatsPattern} _1w
+ * @property {BtcSatsPattern} _1y
+ * @property {BtcSatsPattern} _24h
+ */
+
+/**
+ * Create a _1m1w1y24hPattern7 pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {_1m1w1y24hPattern7}
+ */
+function create_1m1w1y24hPattern7(client, acc) {
+  return {
+    _1m: createBtcSatsPattern(client, _m(acc, '1m')),
+    _1w: createBtcSatsPattern(client, _m(acc, '1w')),
+    _1y: createBtcSatsPattern(client, _m(acc, '1y')),
+    _24h: createBtcSatsPattern(client, _m(acc, '24h')),
+  };
+}
+
 /**
  * @typedef {Object} _1m1w1y2wPattern
  * @property {CentsSatsUsdPattern} _1m
@@ -4028,6 +4012,27 @@ function createCumulativeRollingSumPattern(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} DeltaDominanceTotalPattern
+ * @property {AbsoluteRatePattern3} delta
+ * @property {BpsPercentRatioPattern2} dominance
+ * @property {BtcCentsSatsUsdPattern} total
+ */
+
+/**
+ * Create a DeltaDominanceTotalPattern pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {DeltaDominanceTotalPattern}
+ */
+function createDeltaDominanceTotalPattern(client, acc) {
+  return {
+    delta: createAbsoluteRatePattern3(client, _m(acc, 'delta')),
+    dominance: createBpsPercentRatioPattern2(client, _m(acc, 'dominance')),
+    total: createBtcCentsSatsUsdPattern(client, acc),
+  };
+}
+
 /**
  * @typedef {Object} GreedNetPainPattern
  * @property {CentsUsdPattern3} greedIndex
@@ -4195,6 +4200,44 @@ function createAbsoluteRatePattern2(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} AbsoluteRatePattern3
+ * @property {_1m1w1y24hPattern7} absolute
+ * @property {_1m1w1y24hPattern2} rate
+ */
+
+/**
+ * Create a AbsoluteRatePattern3 pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {AbsoluteRatePattern3}
+ */
+function createAbsoluteRatePattern3(client, acc) {
+  return {
+    absolute: create_1m1w1y24hPattern7(client, acc),
+    rate: create_1m1w1y24hPattern2(client, acc),
+  };
+}
+
+/**
+ * @typedef {Object} AddrUtxoPattern
+ * @property {BtcCentsSatsUsdPattern} addr
+ * @property {BtcCentsSatsUsdPattern} utxo
+ */
+
+/**
+ * Create a AddrUtxoPattern pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {AddrUtxoPattern}
+ */
+function createAddrUtxoPattern(client, acc) {
+  return {
+    addr: createBtcCentsSatsUsdPattern(client, _m(acc, 'addr_amount')),
+    utxo: createBtcCentsSatsUsdPattern(client, _m(acc, 'utxo_amount')),
+  };
+}
+
 /**
  * @typedef {Object} AllSthPattern2
  * @property {BtcCentsDeltaSatsUsdPattern} all
@@ -4348,6 +4391,25 @@ function createBpsRatioPattern(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} BtcSatsPattern
+ * @property {SeriesPattern1<Bitcoin>} btc
+ * @property {SeriesPattern1<SatsSigned>} sats
+ */
+
+/**
+ * Create a BtcSatsPattern pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {BtcSatsPattern}
+ */
+function createBtcSatsPattern(client, acc) {
+  return {
+    btc: createSeriesPattern1(client, acc),
+    sats: createSeriesPattern1(client, _m(acc, 'sats')),
+  };
+}
+
 /**
  * @typedef {Object} CentsUsdPattern3
  * @property {SeriesPattern1<Cents>} cents
@@ -4444,47 +4506,47 @@ function createCoindaysTransferPattern(client, acc) {
 }
 
 /**
- * @typedef {Object} DeltaTotalPattern
- * @property {AbsoluteRatePattern} delta
- * @property {BtcCentsSatsUsdPattern} total
+ * @typedef {Object} FundedTotalPattern
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4} funded
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4} total
  */
 
 /**
- * Create a DeltaTotalPattern pattern node
+ * Create a FundedTotalPattern pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {DeltaTotalPattern}
+ * @returns {FundedTotalPattern}
  */
-function createDeltaTotalPattern(client, acc) {
+function createFundedTotalPattern(client, acc) {
   return {
-    delta: createAbsoluteRatePattern(client, _m(acc, 'delta')),
-    total: createBtcCentsSatsUsdPattern(client, acc),
+    funded: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4(client, acc),
+    total: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4(client, _p('total', acc)),
   };
 }
 
 /**
- * @typedef {Object} FundedTotalPattern
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3} funded
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3} total
+ * @typedef {Object} InPattern2
+ * @property {CentsUsdPattern3} inLoss
+ * @property {CentsUsdPattern3} inProfit
  */
 
 /**
- * Create a FundedTotalPattern pattern node
+ * Create a InPattern2 pattern node
  * @param {BrkClientBase} client
  * @param {string} acc - Accumulated series name
- * @returns {FundedTotalPattern}
+ * @returns {InPattern2}
  */
-function createFundedTotalPattern(client, acc) {
+function createInPattern2(client, acc) {
   return {
-    funded: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(client, acc),
-    total: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(client, _p('total', acc)),
+    inLoss: createCentsUsdPattern3(client, _m(acc, 'loss')),
+    inProfit: createCentsUsdPattern3(client, _m(acc, 'profit')),
   };
 }
 
 /**
  * @typedef {Object} InPattern
- * @property {CentsUsdPattern3} inLoss
- * @property {CentsUsdPattern3} inProfit
+ * @property {SharePattern} inLoss
+ * @property {SharePattern} inProfit
  */
 
 /**
@@ -4495,8 +4557,8 @@ function createFundedTotalPattern(client, acc) {
  */
 function createInPattern(client, acc) {
   return {
-    inLoss: createCentsUsdPattern3(client, _m(acc, 'loss')),
-    inProfit: createCentsUsdPattern3(client, _m(acc, 'profit')),
+    inLoss: createSharePattern(client, _m(acc, 'loss_share')),
+    inProfit: createSharePattern(client, _m(acc, 'profit_share')),
   };
 }
 
@@ -4634,6 +4696,23 @@ function createPricePattern(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} SharePattern
+ * @property {BpsPercentRatioPattern2} share
+ */
+
+/**
+ * Create a SharePattern pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {SharePattern}
+ */
+function createSharePattern(client, acc) {
+  return {
+    share: createBpsPercentRatioPattern2(client, acc),
+  };
+}
+
 /**
  * @typedef {Object} TransferPattern
  * @property {AverageBlockCumulativeSumPattern3} transferVolume
@@ -5028,14 +5107,15 @@ function createTransferPattern(client, acc) {
  * @property {SeriesTree_Addrs_Raw} raw
  * @property {SeriesTree_Addrs_Indexes} indexes
  * @property {SeriesTree_Addrs_Data} data
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3} funded
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3} empty
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4} funded
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4} empty
  * @property {SeriesTree_Addrs_Activity} activity
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3} total
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} new
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4} total
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} new
  * @property {SeriesTree_Addrs_Reused} reused
  * @property {SeriesTree_Addrs_Exposed} exposed
  * @property {SeriesTree_Addrs_Delta} delta
+ * @property {SeriesTree_Addrs_AvgAmount} avgAmount
  */
 
 /**
@@ -5148,11 +5228,11 @@ function createTransferPattern(client, acc) {
 
 /**
  * @typedef {Object} SeriesTree_Addrs_Reused_Events
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} outputToReusedAddrCount
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} outputToReusedAddrShare
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} outputToReusedAddrCount
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} outputToReusedAddrShare
  * @property {_1m1w1y24hBpsPercentRatioPattern} spendableOutputToReusedAddrShare
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} inputFromReusedAddrCount
- * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} inputFromReusedAddrShare
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} inputFromReusedAddrCount
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} inputFromReusedAddrShare
  * @property {_1m1w1y24hBlockPattern} activeReusedAddrCount
  * @property {SeriesTree_Addrs_Reused_Events_ActiveReusedAddrShare} activeReusedAddrShare
  */
@@ -5183,6 +5263,20 @@ function createTransferPattern(client, acc) {
  * @property {BtcCentsSatsUsdPattern} p2wsh
  * @property {BtcCentsSatsUsdPattern} p2tr
  * @property {BtcCentsSatsUsdPattern} p2a
+ * @property {SeriesTree_Addrs_Exposed_Supply_Share} share
+ */
+
+/**
+ * @typedef {Object} SeriesTree_Addrs_Exposed_Supply_Share
+ * @property {BpsPercentRatioPattern2} all
+ * @property {BpsPercentRatioPattern2} p2pk65
+ * @property {BpsPercentRatioPattern2} p2pk33
+ * @property {BpsPercentRatioPattern2} p2pkh
+ * @property {BpsPercentRatioPattern2} p2sh
+ * @property {BpsPercentRatioPattern2} p2wpkh
+ * @property {BpsPercentRatioPattern2} p2wsh
+ * @property {BpsPercentRatioPattern2} p2tr
+ * @property {BpsPercentRatioPattern2} p2a
  */
 
 /**
@@ -5198,6 +5292,19 @@ function createTransferPattern(client, acc) {
  * @property {AbsoluteRatePattern} p2a
  */
 
+/**
+ * @typedef {Object} SeriesTree_Addrs_AvgAmount
+ * @property {AddrUtxoPattern} all
+ * @property {AddrUtxoPattern} p2pk65
+ * @property {AddrUtxoPattern} p2pk33
+ * @property {AddrUtxoPattern} p2pkh
+ * @property {AddrUtxoPattern} p2sh
+ * @property {AddrUtxoPattern} p2wpkh
+ * @property {AddrUtxoPattern} p2wsh
+ * @property {AddrUtxoPattern} p2tr
+ * @property {AddrUtxoPattern} p2a
+ */
+
 /**
  * @typedef {Object} SeriesTree_Scripts
  * @property {SeriesTree_Scripts_Raw} raw
@@ -6217,21 +6324,13 @@ function createTransferPattern(client, acc) {
 
 /**
  * @typedef {Object} SeriesTree_Cohorts_Utxo_All
- * @property {SeriesTree_Cohorts_Utxo_All_Supply} supply
+ * @property {DeltaDominanceHalfInTotalPattern2} supply
  * @property {SeriesTree_Cohorts_Utxo_All_Outputs} outputs
  * @property {SeriesTree_Cohorts_Utxo_All_Activity} activity
  * @property {SeriesTree_Cohorts_Utxo_All_Realized} realized
  * @property {SeriesTree_Cohorts_Utxo_All_CostBasis} costBasis
  * @property {SeriesTree_Cohorts_Utxo_All_Unrealized} unrealized
- */
-
-/**
- * @typedef {Object} SeriesTree_Cohorts_Utxo_All_Supply
- * @property {BtcCentsSatsUsdPattern} total
- * @property {AbsoluteRatePattern} delta
- * @property {BtcCentsSatsUsdPattern} half
- * @property {BtcCentsSatsToUsdPattern2} inProfit
- * @property {BtcCentsSatsToUsdPattern2} inLoss
+ * @property {InPattern} investedCapital
  */
 
 /**
@@ -6259,9 +6358,9 @@ function createTransferPattern(client, acc) {
  * @property {BlockChangeCumulativeDeltaSumPattern} netPnl
  * @property {SeriesTree_Cohorts_Utxo_All_Realized_Sopr} sopr
  * @property {BlockCumulativeSumPattern} grossPnl
- * @property {_1m1w1y24hPattern7} sellSideRiskRatio
+ * @property {_1m1w1y24hPattern8} sellSideRiskRatio
  * @property {BlockCumulativeSumPattern} peakRegret
- * @property {PricePattern} investor
+ * @property {PricePattern} capitalized
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
  */
 
@@ -6393,9 +6492,9 @@ function createTransferPattern(client, acc) {
  * @property {SeriesTree_Cohorts_Utxo_All_Unrealized_Loss} loss
  * @property {SeriesTree_Cohorts_Utxo_All_Unrealized_NetPnl} netPnl
  * @property {CentsUsdPattern3} grossPnl
- * @property {InPattern} investedCapital
- * @property {SeriesPattern18<CentsSquaredSats>} investorCapInProfitRaw
- * @property {SeriesPattern18<CentsSquaredSats>} investorCapInLossRaw
+ * @property {InPattern2} investedCapital
+ * @property {SeriesPattern18<CentsSquaredSats>} capitalizedCapInProfitRaw
+ * @property {SeriesPattern18<CentsSquaredSats>} capitalizedCapInLossRaw
  * @property {SeriesTree_Cohorts_Utxo_All_Unrealized_Sentiment} sentiment
  */
 
@@ -6432,12 +6531,13 @@ function createTransferPattern(client, acc) {
 
 /**
  * @typedef {Object} SeriesTree_Cohorts_Utxo_Sth
- * @property {DeltaHalfInToTotalPattern2} supply
+ * @property {DeltaDominanceHalfInTotalPattern2} supply
  * @property {SpendingSpentUnspentPattern} outputs
  * @property {CoindaysCoinyearsDormancyTransferPattern} activity
  * @property {SeriesTree_Cohorts_Utxo_Sth_Realized} realized
  * @property {InMaxMinPerSupplyPattern} costBasis
- * @property {GrossInvestedInvestorLossNetNuplProfitSentimentPattern2} unrealized
+ * @property {CapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2} unrealized
+ * @property {InPattern} investedCapital
  */
 
 /**
@@ -6450,9 +6550,9 @@ function createTransferPattern(client, acc) {
  * @property {BlockChangeCumulativeDeltaSumPattern} netPnl
  * @property {AdjustedRatioValuePattern} sopr
  * @property {BlockCumulativeSumPattern} grossPnl
- * @property {_1m1w1y24hPattern7} sellSideRiskRatio
+ * @property {_1m1w1y24hPattern8} sellSideRiskRatio
  * @property {BlockCumulativeSumPattern} peakRegret
- * @property {PricePattern} investor
+ * @property {PricePattern} capitalized
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
  */
 
@@ -6554,12 +6654,13 @@ function createTransferPattern(client, acc) {
 
 /**
  * @typedef {Object} SeriesTree_Cohorts_Utxo_Lth
- * @property {DeltaHalfInToTotalPattern2} supply
+ * @property {DeltaDominanceHalfInTotalPattern2} supply
  * @property {SpendingSpentUnspentPattern} outputs
  * @property {CoindaysCoinyearsDormancyTransferPattern} activity
  * @property {SeriesTree_Cohorts_Utxo_Lth_Realized} realized
  * @property {InMaxMinPerSupplyPattern} costBasis
- * @property {GrossInvestedInvestorLossNetNuplProfitSentimentPattern2} unrealized
+ * @property {CapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2} unrealized
+ * @property {InPattern} investedCapital
  */
 
 /**
@@ -6572,9 +6673,9 @@ function createTransferPattern(client, acc) {
  * @property {BlockChangeCumulativeDeltaSumPattern} netPnl
  * @property {SeriesTree_Cohorts_Utxo_Lth_Realized_Sopr} sopr
  * @property {BlockCumulativeSumPattern} grossPnl
- * @property {_1m1w1y24hPattern7} sellSideRiskRatio
+ * @property {_1m1w1y24hPattern8} sellSideRiskRatio
  * @property {BlockCumulativeSumPattern} peakRegret
- * @property {PricePattern} investor
+ * @property {PricePattern} capitalized
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
  */
 
@@ -7005,7 +7106,7 @@ function createTransferPattern(client, acc) {
  * @extends BrkClientBase
  */
 class BrkClient extends BrkClientBase {
-  VERSION = "v0.3.0-beta.2";
+  VERSION = "v0.3.0-beta.4";
 
   INDEXES = /** @type {const} */ ([
     "minute10",
@@ -8186,15 +8287,14 @@ class BrkClient extends BrkClientBase {
   constructor(options) {
     super(options);
     /** @type {SeriesTree} */
-    this.series = this._buildTree('');
+    this.series = this._buildTree();
   }
 
   /**
    * @private
-   * @param {string} basePath
    * @returns {SeriesTree}
    */
-  _buildTree(basePath) {
+  _buildTree() {
     return {
       blocks: {
         blockhash: createSeriesPattern18(this, 'blockhash'),
@@ -8501,8 +8601,8 @@ class BrkClient extends BrkClientBase {
           funded: createSeriesPattern34(this, 'funded_addr_data'),
           empty: createSeriesPattern35(this, 'empty_addr_data'),
         },
-        funded: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(this, 'addr_count'),
-        empty: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(this, 'empty_addr_count'),
+        funded: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4(this, 'addr_count'),
+        empty: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4(this, 'empty_addr_count'),
         activity: {
           all: {
             reactivated: create_1m1w1y24hBlockPattern(this, 'reactivated_addrs'),
@@ -8520,16 +8620,16 @@ class BrkClient extends BrkClientBase {
           p2tr: createActiveBidirectionalReactivatedReceivingSendingPattern(this, 'p2tr'),
           p2a: createActiveBidirectionalReactivatedReceivingSendingPattern(this, 'p2a'),
         },
-        total: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern3(this, 'total_addr_count'),
-        new: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(this, 'new_addr_count'),
+        total: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4(this, 'total_addr_count'),
+        new: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'new_addr_count'),
         reused: {
           count: createFundedTotalPattern(this, 'reused_addr_count'),
           events: {
-            outputToReusedAddrCount: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(this, 'output_to_reused_addr_count'),
-            outputToReusedAddrShare: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'output_to_reused_addr_share'),
+            outputToReusedAddrCount: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'output_to_reused_addr_count'),
+            outputToReusedAddrShare: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7(this, 'output_to_reused_addr_share'),
             spendableOutputToReusedAddrShare: create_1m1w1y24hBpsPercentRatioPattern(this, 'spendable_output_to_reused_addr_share'),
-            inputFromReusedAddrCount: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(this, 'input_from_reused_addr_count'),
-            inputFromReusedAddrShare: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'input_from_reused_addr_share'),
+            inputFromReusedAddrCount: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'input_from_reused_addr_count'),
+            inputFromReusedAddrShare: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7(this, 'input_from_reused_addr_share'),
             activeReusedAddrCount: create_1m1w1y24hBlockPattern(this, 'active_reused_addr_count'),
             activeReusedAddrShare: {
               block: createSeriesPattern18(this, 'active_reused_addr_share'),
@@ -8543,15 +8643,26 @@ class BrkClient extends BrkClientBase {
         exposed: {
           count: createFundedTotalPattern(this, 'exposed_addr_count'),
           supply: {
-            all: createBtcCentsSatsUsdPattern(this, 'exposed_addr_supply'),
-            p2pk65: createBtcCentsSatsUsdPattern(this, 'p2pk65_exposed_addr_supply'),
-            p2pk33: createBtcCentsSatsUsdPattern(this, 'p2pk33_exposed_addr_supply'),
-            p2pkh: createBtcCentsSatsUsdPattern(this, 'p2pkh_exposed_addr_supply'),
-            p2sh: createBtcCentsSatsUsdPattern(this, 'p2sh_exposed_addr_supply'),
-            p2wpkh: createBtcCentsSatsUsdPattern(this, 'p2wpkh_exposed_addr_supply'),
-            p2wsh: createBtcCentsSatsUsdPattern(this, 'p2wsh_exposed_addr_supply'),
-            p2tr: createBtcCentsSatsUsdPattern(this, 'p2tr_exposed_addr_supply'),
-            p2a: createBtcCentsSatsUsdPattern(this, 'p2a_exposed_addr_supply'),
+            all: createBtcCentsSatsUsdPattern(this, 'exposed_supply'),
+            p2pk65: createBtcCentsSatsUsdPattern(this, 'p2pk65_exposed_supply'),
+            p2pk33: createBtcCentsSatsUsdPattern(this, 'p2pk33_exposed_supply'),
+            p2pkh: createBtcCentsSatsUsdPattern(this, 'p2pkh_exposed_supply'),
+            p2sh: createBtcCentsSatsUsdPattern(this, 'p2sh_exposed_supply'),
+            p2wpkh: createBtcCentsSatsUsdPattern(this, 'p2wpkh_exposed_supply'),
+            p2wsh: createBtcCentsSatsUsdPattern(this, 'p2wsh_exposed_supply'),
+            p2tr: createBtcCentsSatsUsdPattern(this, 'p2tr_exposed_supply'),
+            p2a: createBtcCentsSatsUsdPattern(this, 'p2a_exposed_supply'),
+            share: {
+              all: createBpsPercentRatioPattern2(this, 'exposed_supply_share'),
+              p2pk65: createBpsPercentRatioPattern2(this, 'p2pk65_exposed_supply_share'),
+              p2pk33: createBpsPercentRatioPattern2(this, 'p2pk33_exposed_supply_share'),
+              p2pkh: createBpsPercentRatioPattern2(this, 'p2pkh_exposed_supply_share'),
+              p2sh: createBpsPercentRatioPattern2(this, 'p2sh_exposed_supply_share'),
+              p2wpkh: createBpsPercentRatioPattern2(this, 'p2wpkh_exposed_supply_share'),
+              p2wsh: createBpsPercentRatioPattern2(this, 'p2wsh_exposed_supply_share'),
+              p2tr: createBpsPercentRatioPattern2(this, 'p2tr_exposed_supply_share'),
+              p2a: createBpsPercentRatioPattern2(this, 'p2a_exposed_supply_share'),
+            },
           },
         },
         delta: {
@@ -8565,6 +8676,17 @@ class BrkClient extends BrkClientBase {
           p2tr: createAbsoluteRatePattern(this, 'p2tr_addr_count'),
           p2a: createAbsoluteRatePattern(this, 'p2a_addr_count'),
         },
+        avgAmount: {
+          all: createAddrUtxoPattern(this, 'avg'),
+          p2pk65: createAddrUtxoPattern(this, 'p2pk65_avg'),
+          p2pk33: createAddrUtxoPattern(this, 'p2pk33_avg'),
+          p2pkh: createAddrUtxoPattern(this, 'p2pkh_avg'),
+          p2sh: createAddrUtxoPattern(this, 'p2sh_avg'),
+          p2wpkh: createAddrUtxoPattern(this, 'p2wpkh_avg'),
+          p2wsh: createAddrUtxoPattern(this, 'p2wsh_avg'),
+          p2tr: createAddrUtxoPattern(this, 'p2tr_avg'),
+          p2a: createAddrUtxoPattern(this, 'p2a_avg'),
+        },
       },
       scripts: {
         raw: {
@@ -9279,13 +9401,7 @@ class BrkClient extends BrkClientBase {
       cohorts: {
         utxo: {
           all: {
-            supply: {
-              total: createBtcCentsSatsUsdPattern(this, 'supply'),
-              delta: createAbsoluteRatePattern(this, 'supply_delta'),
-              half: createBtcCentsSatsUsdPattern(this, 'supply_half'),
-              inProfit: createBtcCentsSatsToUsdPattern2(this, 'supply_in_profit'),
-              inLoss: createBtcCentsSatsToUsdPattern2(this, 'supply_in_loss'),
-            },
+            supply: createDeltaDominanceHalfInTotalPattern2(this, 'supply'),
             outputs: {
               unspentCount: createBaseDeltaPattern(this, 'utxo_count'),
               spentCount: createAverageBlockCumulativeSumPattern2(this, 'spent_utxo_count'),
@@ -9392,9 +9508,9 @@ class BrkClient extends BrkClientBase {
                 },
               },
               grossPnl: createBlockCumulativeSumPattern(this, 'realized_gross_pnl'),
-              sellSideRiskRatio: create_1m1w1y24hPattern7(this, 'sell_side_risk_ratio'),
+              sellSideRiskRatio: create_1m1w1y24hPattern8(this, 'sell_side_risk_ratio'),
               peakRegret: createBlockCumulativeSumPattern(this, 'realized_peak_regret'),
-              investor: createPricePattern(this, 'investor_price'),
+              capitalized: createPricePattern(this, 'capitalized_price'),
               profitToLossRatio: create_1m1w1y24hPattern(this, 'realized_profit_to_loss_ratio'),
             },
             costBasis: {
@@ -9427,18 +9543,19 @@ class BrkClient extends BrkClientBase {
                 toOwnGrossPnl: createBpsPercentRatioPattern(this, 'net_unrealized_pnl_to_own_gross_pnl'),
               },
               grossPnl: createCentsUsdPattern3(this, 'unrealized_gross_pnl'),
-              investedCapital: createInPattern(this, 'invested_capital_in'),
-              investorCapInProfitRaw: createSeriesPattern18(this, 'investor_cap_in_profit_raw'),
-              investorCapInLossRaw: createSeriesPattern18(this, 'investor_cap_in_loss_raw'),
+              investedCapital: createInPattern2(this, 'invested_capital_in'),
+              capitalizedCapInProfitRaw: createSeriesPattern18(this, 'capitalized_cap_in_profit_raw'),
+              capitalizedCapInLossRaw: createSeriesPattern18(this, 'capitalized_cap_in_loss_raw'),
               sentiment: {
                 painIndex: createCentsUsdPattern3(this, 'pain_index'),
                 greedIndex: createCentsUsdPattern3(this, 'greed_index'),
                 net: createCentsUsdPattern(this, 'net_sentiment'),
               },
             },
+            investedCapital: createInPattern(this, 'invested_capital_in'),
           },
           sth: {
-            supply: createDeltaHalfInToTotalPattern2(this, 'sth_supply'),
+            supply: createDeltaDominanceHalfInTotalPattern2(this, 'sth_supply'),
             outputs: createSpendingSpentUnspentPattern(this, 'sth'),
             activity: createCoindaysCoinyearsDormancyTransferPattern(this, 'sth'),
             realized: {
@@ -9528,16 +9645,17 @@ class BrkClient extends BrkClientBase {
               netPnl: createBlockChangeCumulativeDeltaSumPattern(this, 'sth_net'),
               sopr: createAdjustedRatioValuePattern(this, 'sth'),
               grossPnl: createBlockCumulativeSumPattern(this, 'sth_realized_gross_pnl'),
-              sellSideRiskRatio: create_1m1w1y24hPattern7(this, 'sth_sell_side_risk_ratio'),
+              sellSideRiskRatio: create_1m1w1y24hPattern8(this, 'sth_sell_side_risk_ratio'),
               peakRegret: createBlockCumulativeSumPattern(this, 'sth_realized_peak_regret'),
-              investor: createPricePattern(this, 'sth_investor_price'),
+              capitalized: createPricePattern(this, 'sth_capitalized_price'),
               profitToLossRatio: create_1m1w1y24hPattern(this, 'sth_realized_profit_to_loss_ratio'),
             },
             costBasis: createInMaxMinPerSupplyPattern(this, 'sth'),
-            unrealized: createGrossInvestedInvestorLossNetNuplProfitSentimentPattern2(this, 'sth'),
+            unrealized: createCapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2(this, 'sth'),
+            investedCapital: createInPattern(this, 'sth_invested_capital_in'),
           },
           lth: {
-            supply: createDeltaHalfInToTotalPattern2(this, 'lth_supply'),
+            supply: createDeltaDominanceHalfInTotalPattern2(this, 'lth_supply'),
             outputs: createSpendingSpentUnspentPattern(this, 'lth'),
             activity: createCoindaysCoinyearsDormancyTransferPattern(this, 'lth'),
             realized: {
@@ -9630,13 +9748,14 @@ class BrkClient extends BrkClientBase {
                 ratio: create_1m1w1y24hPattern(this, 'lth_sopr'),
               },
               grossPnl: createBlockCumulativeSumPattern(this, 'lth_realized_gross_pnl'),
-              sellSideRiskRatio: create_1m1w1y24hPattern7(this, 'lth_sell_side_risk_ratio'),
+              sellSideRiskRatio: create_1m1w1y24hPattern8(this, 'lth_sell_side_risk_ratio'),
               peakRegret: createBlockCumulativeSumPattern(this, 'lth_realized_peak_regret'),
-              investor: createPricePattern(this, 'lth_investor_price'),
+              capitalized: createPricePattern(this, 'lth_capitalized_price'),
               profitToLossRatio: create_1m1w1y24hPattern(this, 'lth_realized_profit_to_loss_ratio'),
             },
             costBasis: createInMaxMinPerSupplyPattern(this, 'lth'),
-            unrealized: createGrossInvestedInvestorLossNetNuplProfitSentimentPattern2(this, 'lth'),
+            unrealized: createCapitalizedGrossInvestedLossNetNuplProfitSentimentPattern2(this, 'lth'),
+            investedCapital: createInPattern(this, 'lth_invested_capital_in'),
           },
           ageRange: {
             under1h: createActivityOutputsRealizedSupplyUnrealizedPattern(this, 'utxos_under_1h_old'),
@@ -10383,63 +10502,6 @@ class BrkClient extends BrkClientBase {
     return this.getJson(path, { signal, onUpdate });
   }
 
-  /**
-   * Available cost basis cohorts
-   *
-   * List available cohorts for cost basis distribution.
-   *
-   * Endpoint: `GET /api/series/cost-basis`
-   * @param {{ signal?: AbortSignal, onUpdate?: (value: string[]) => void }} [options]
-   * @returns {Promise<string[]>}
-   */
-  async getCostBasisCohorts({ signal, onUpdate } = {}) {
-    const path = `/api/series/cost-basis`;
-    return this.getJson(path, { signal, onUpdate });
-  }
-
-  /**
-   * Available cost basis dates
-   *
-   * List available dates for a cohort's cost basis distribution.
-   *
-   * Endpoint: `GET /api/series/cost-basis/{cohort}/dates`
-   *
-   * @param {Cohort} cohort
-   * @param {{ signal?: AbortSignal, onUpdate?: (value: Date[]) => void }} [options]
-   * @returns {Promise<Date[]>}
-   */
-  async getCostBasisDates(cohort, { signal, onUpdate } = {}) {
-    const path = `/api/series/cost-basis/${cohort}/dates`;
-    return this.getJson(path, { signal, onUpdate });
-  }
-
-  /**
-   * Cost basis distribution
-   *
-   * Get the cost basis distribution for a cohort on a specific date.
-   *
-   * Query params:
-   * - `bucket`: raw (default), lin200, lin500, lin1000, log10, log50, log100
-   * - `value`: supply (default, in BTC), realized (USD), unrealized (USD)
-   *
-   * Endpoint: `GET /api/series/cost-basis/{cohort}/{date}`
-   *
-   * @param {Cohort} cohort
-   * @param {string} date
-   * @param {CostBasisBucket=} [bucket] - Bucket type for aggregation. Default: raw (no aggregation).
-   * @param {CostBasisValue=} [value] - Value type to return. Default: supply.
-   * @param {{ signal?: AbortSignal, onUpdate?: (value: Object) => void }} [options]
-   * @returns {Promise<Object>}
-   */
-  async getCostBasis(cohort, date, bucket, value, { signal, onUpdate } = {}) {
-    const params = new URLSearchParams();
-    if (bucket !== undefined) params.set('bucket', String(bucket));
-    if (value !== undefined) params.set('value', String(value));
-    const query = params.toString();
-    const path = `/api/series/cost-basis/${cohort}/${date}${query ? '?' + query : ''}`;
-    return this.getJson(path, { signal, onUpdate });
-  }
-
   /**
    * Series count
    *
@@ -10822,6 +10884,81 @@ class BrkClient extends BrkClientBase {
     return this.getJson(path, { signal, onUpdate });
   }
 
+  /**
+   * Available URPD cohorts
+   *
+   * Cohorts for which URPD data is available. Returns names like `all`, `sth`, `lth`, `utxos_under_1h_old`.
+   *
+   * Endpoint: `GET /api/urpd`
+   * @param {{ signal?: AbortSignal, onUpdate?: (value: Cohort[]) => void }} [options]
+   * @returns {Promise<Cohort[]>}
+   */
+  async listUrpdCohorts({ signal, onUpdate } = {}) {
+    const path = `/api/urpd`;
+    return this.getJson(path, { signal, onUpdate });
+  }
+
+  /**
+   * Latest URPD
+   *
+   * URPD for the most recent available date in the cohort. The response's `date` field echoes which date was served.
+   *
+   * See the URPD tag description for the response shape and `agg` options.
+   *
+   * Endpoint: `GET /api/urpd/{cohort}`
+   *
+   * @param {Cohort} cohort
+   * @param {UrpdAggregation=} [agg] - Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
+   * @param {{ signal?: AbortSignal, onUpdate?: (value: Urpd) => void }} [options]
+   * @returns {Promise<Urpd>}
+   */
+  async getUrpd(cohort, agg, { signal, onUpdate } = {}) {
+    const params = new URLSearchParams();
+    if (agg !== undefined) params.set('agg', String(agg));
+    const query = params.toString();
+    const path = `/api/urpd/${cohort}${query ? '?' + query : ''}`;
+    return this.getJson(path, { signal, onUpdate });
+  }
+
+  /**
+   * Available URPD dates
+   *
+   * Dates for which a URPD snapshot is available for the cohort. One entry per UTC day, sorted ascending.
+   *
+   * Endpoint: `GET /api/urpd/{cohort}/dates`
+   *
+   * @param {Cohort} cohort
+   * @param {{ signal?: AbortSignal, onUpdate?: (value: Date[]) => void }} [options]
+   * @returns {Promise<Date[]>}
+   */
+  async listUrpdDates(cohort, { signal, onUpdate } = {}) {
+    const path = `/api/urpd/${cohort}/dates`;
+    return this.getJson(path, { signal, onUpdate });
+  }
+
+  /**
+   * URPD at date
+   *
+   * URPD for a (cohort, date) pair. Returns `{ cohort, date, aggregation, close, total_supply, buckets }` where each bucket is `{ price_floor, supply, realized_cap, unrealized_pnl }`.
+   *
+   * See the URPD tag description for unit conventions and `agg` options.
+   *
+   * Endpoint: `GET /api/urpd/{cohort}/{date}`
+   *
+   * @param {Cohort} cohort
+   * @param {string} date
+   * @param {UrpdAggregation=} [agg] - Aggregation strategy. Default: raw (no aggregation). Accepts `bucket` as alias.
+   * @param {{ signal?: AbortSignal, onUpdate?: (value: Urpd) => void }} [options]
+   * @returns {Promise<Urpd>}
+   */
+  async getUrpdAt(cohort, date, agg, { signal, onUpdate } = {}) {
+    const params = new URLSearchParams();
+    if (agg !== undefined) params.set('agg', String(agg));
+    const query = params.toString();
+    const path = `/api/urpd/${cohort}/${date}${query ? '?' + query : ''}`;
+    return this.getJson(path, { signal, onUpdate });
+  }
+
   /**
    * Block (v1)
    *

package/package.json

@@ -40,5 +40,5 @@
     "url": "git+https://github.com/bitcoinresearchkit/brk.git"
   },
   "type": "module",
-  "version": "0.3.0-beta.2"
+  "version": "0.3.0-beta.4"
 }