brk-client 0.3.0-beta.3 → 0.3.0-beta.5

package/index.js

@@ -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 {("all"|"sth"|"lth"|"under_1h_old"|"1h_to_1d_old"|"1d_to_1w_old"|"1w_to_1m_old"|"1m_to_2m_old"|"2m_to_3m_old"|"3m_to_4m_old"|"4m_to_5m_old"|"5m_to_6m_old"|"6m_to_1y_old"|"1y_to_2y_old"|"2y_to_3y_old"|"3y_to_4y_old"|"4y_to_5y_old"|"5y_to_6y_old"|"6y_to_7y_old"|"7y_to_8y_old"|"8y_to_10y_old"|"10y_to_12y_old"|"12y_to_15y_old"|"over_15y_old")} 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
  */
@@ -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
  *
@@ -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
  */
 
@@ -2265,6 +2303,20 @@ function createAverageBaseCumulativeMaxMedianMinPct10Pct25Pct75Pct90SumPattern(c
   };
 }
 
+/**
+ * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshSharePattern
+ * @property {BtcCentsSatsUsdPattern} all
+ * @property {BtcCentsSatsUsdPattern} p2a
+ * @property {BtcCentsSatsUsdPattern} p2pk33
+ * @property {BtcCentsSatsUsdPattern} p2pk65
+ * @property {BtcCentsSatsUsdPattern} p2pkh
+ * @property {BtcCentsSatsUsdPattern} p2sh
+ * @property {BtcCentsSatsUsdPattern} p2tr
+ * @property {BtcCentsSatsUsdPattern} p2wpkh
+ * @property {BtcCentsSatsUsdPattern} p2wsh
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} share
+ */
+
 /**
  * @typedef {Object} IndexPct0Pct1Pct2Pct5Pct95Pct98Pct99ScorePattern
  * @property {SeriesPattern1<StoredI8>} index
@@ -2333,6 +2385,39 @@ function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5
+ * @property {BpsPercentRatioPattern2} all
+ * @property {BpsPercentRatioPattern2} p2a
+ * @property {BpsPercentRatioPattern2} p2pk33
+ * @property {BpsPercentRatioPattern2} p2pk65
+ * @property {BpsPercentRatioPattern2} p2pkh
+ * @property {BpsPercentRatioPattern2} p2sh
+ * @property {BpsPercentRatioPattern2} p2tr
+ * @property {BpsPercentRatioPattern2} p2wpkh
+ * @property {BpsPercentRatioPattern2} p2wsh
+ */
+
+/**
+ * Create a AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5 pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5}
+ */
+function createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(client, acc) {
+  return {
+    all: createBpsPercentRatioPattern2(client, acc),
+    p2a: createBpsPercentRatioPattern2(client, _p('p2a', acc)),
+    p2pk33: createBpsPercentRatioPattern2(client, _p('p2pk33', acc)),
+    p2pk65: createBpsPercentRatioPattern2(client, _p('p2pk65', acc)),
+    p2pkh: createBpsPercentRatioPattern2(client, _p('p2pkh', acc)),
+    p2sh: createBpsPercentRatioPattern2(client, _p('p2sh', acc)),
+    p2tr: createBpsPercentRatioPattern2(client, _p('p2tr', acc)),
+    p2wpkh: createBpsPercentRatioPattern2(client, _p('p2wpkh', acc)),
+    p2wsh: createBpsPercentRatioPattern2(client, _p('p2wsh', acc)),
+  };
+}
+
 /**
  * @typedef {Object} AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4
  * @property {SeriesPattern1<StoredU64>} all
@@ -2566,6 +2651,17 @@ function create_1m1w1y24hBpsPercentRatioPattern(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} ActiveInputOutputSpendablePattern
+ * @property {_1m1w1y24hBlockPattern} activeReusedAddrCount
+ * @property {_1m1w1y24hBlockPattern2} activeReusedAddrShare
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} inputFromReusedAddrCount
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} inputFromReusedAddrShare
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} outputToReusedAddrCount
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} outputToReusedAddrShare
+ * @property {_1m1w1y24hBpsPercentRatioPattern} spendableOutputToReusedAddrShare
+ */
+
 /**
  * @typedef {Object} CapLossMvrvNetPriceProfitSoprPattern
  * @property {CentsDeltaUsdPattern} cap
@@ -2821,7 +2917,7 @@ function createCentsNegativeToUsdPattern2(client, acc) {
 
 /**
  * @typedef {Object} DeltaDominanceHalfInTotalPattern2
- * @property {AbsoluteRatePattern} delta
+ * @property {AbsoluteRatePattern3} delta
  * @property {BpsPercentRatioPattern2} dominance
  * @property {BtcCentsSatsUsdPattern} half
  * @property {BtcCentsSatsShareUsdPattern} inLoss
@@ -2837,7 +2933,7 @@ function createCentsNegativeToUsdPattern2(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: createBtcCentsSatsShareUsdPattern(client, _m(acc, 'in_loss')),
@@ -2848,7 +2944,7 @@ function createDeltaDominanceHalfInTotalPattern2(client, acc) {
 
 /**
  * @typedef {Object} DeltaDominanceHalfInTotalPattern
- * @property {AbsoluteRatePattern} delta
+ * @property {AbsoluteRatePattern3} delta
  * @property {BpsPercentRatioPattern2} dominance
  * @property {BtcCentsSatsUsdPattern} half
  * @property {BtcCentsSatsUsdPattern} inLoss
@@ -2864,7 +2960,7 @@ function createDeltaDominanceHalfInTotalPattern2(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: createBtcCentsSatsUsdPattern(client, _m(acc, 'in_loss')),
@@ -2873,6 +2969,31 @@ function createDeltaDominanceHalfInTotalPattern(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} _1m1w1y24hBlockPattern2
+ * @property {SeriesPattern1<StoredF32>} _1m
+ * @property {SeriesPattern1<StoredF32>} _1w
+ * @property {SeriesPattern1<StoredF32>} _1y
+ * @property {SeriesPattern1<StoredF32>} _24h
+ * @property {SeriesPattern18<StoredF32>} block
+ */
+
+/**
+ * Create a _1m1w1y24hBlockPattern2 pattern node
+ * @param {BrkClientBase} client
+ * @param {string} acc - Accumulated series name
+ * @returns {_1m1w1y24hBlockPattern2}
+ */
+function create_1m1w1y24hBlockPattern2(client, acc) {
+  return {
+    _1m: createSeriesPattern1(client, _m(acc, 'average_1m')),
+    _1w: createSeriesPattern1(client, _m(acc, 'average_1w')),
+    _1y: createSeriesPattern1(client, _m(acc, 'average_1y')),
+    _24h: createSeriesPattern1(client, _m(acc, 'average_24h')),
+    block: createSeriesPattern18(client, acc),
+  };
+}
+
 /**
  * @typedef {Object} _1m1w1y24hBlockPattern
  * @property {SeriesPattern1<StoredF32>} _1m
@@ -3052,7 +3173,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
  */
@@ -3067,7 +3188,7 @@ 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')),
   };
@@ -3206,7 +3327,7 @@ function create_1m1w1y24hPattern2(client, acc) {
 }
 
 /**
- * @typedef {Object} _1m1w1y24hPattern7
+ * @typedef {Object} _1m1w1y24hPattern8
  * @property {BpsPercentRatioPattern4} _1m
  * @property {BpsPercentRatioPattern4} _1w
  * @property {BpsPercentRatioPattern4} _1y
@@ -3214,12 +3335,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')),
@@ -3274,6 +3395,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
@@ -3930,6 +4074,13 @@ function createCentsSatsUsdPattern(client, acc) {
   };
 }
 
+/**
+ * @typedef {Object} CountEventsSupplyPattern
+ * @property {FundedTotalPattern} count
+ * @property {ActiveInputOutputSpendablePattern} events
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshSharePattern} supply
+ */
+
 /**
  * @typedef {Object} CumulativeRollingSumPattern
  * @property {SeriesPattern1<StoredU64>} cumulative
@@ -3953,7 +4104,7 @@ function createCumulativeRollingSumPattern(client, acc) {
 
 /**
  * @typedef {Object} DeltaDominanceTotalPattern
- * @property {AbsoluteRatePattern} delta
+ * @property {AbsoluteRatePattern3} delta
  * @property {BpsPercentRatioPattern2} dominance
  * @property {BtcCentsSatsUsdPattern} total
  */
@@ -3966,7 +4117,7 @@ function createCumulativeRollingSumPattern(client, acc) {
  */
 function createDeltaDominanceTotalPattern(client, acc) {
   return {
-    delta: createAbsoluteRatePattern(client, _m(acc, 'delta')),
+    delta: createAbsoluteRatePattern3(client, _m(acc, 'delta')),
     dominance: createBpsPercentRatioPattern2(client, _m(acc, 'dominance')),
     total: createBtcCentsSatsUsdPattern(client, acc),
   };
@@ -4139,6 +4290,25 @@ 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
@@ -4311,6 +4481,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
@@ -5014,6 +5203,7 @@ function createTransferPattern(client, acc) {
  * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern4} total
  * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} new
  * @property {SeriesTree_Addrs_Reused} reused
+ * @property {SeriesTree_Addrs_Respent} respent
  * @property {SeriesTree_Addrs_Exposed} exposed
  * @property {SeriesTree_Addrs_Delta} delta
  * @property {SeriesTree_Addrs_AvgAmount} avgAmount
@@ -5125,6 +5315,7 @@ function createTransferPattern(client, acc) {
  * @typedef {Object} SeriesTree_Addrs_Reused
  * @property {FundedTotalPattern} count
  * @property {SeriesTree_Addrs_Reused_Events} events
+ * @property {SeriesTree_Addrs_Reused_Supply} supply
  */
 
 /**
@@ -5135,26 +5326,43 @@ function createTransferPattern(client, acc) {
  * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} inputFromReusedAddrCount
  * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} inputFromReusedAddrShare
  * @property {_1m1w1y24hBlockPattern} activeReusedAddrCount
- * @property {SeriesTree_Addrs_Reused_Events_ActiveReusedAddrShare} activeReusedAddrShare
+ * @property {_1m1w1y24hBlockPattern2} activeReusedAddrShare
  */
 
 /**
- * @typedef {Object} SeriesTree_Addrs_Reused_Events_ActiveReusedAddrShare
- * @property {SeriesPattern18<StoredF32>} block
- * @property {SeriesPattern1<StoredF32>} _24h
- * @property {SeriesPattern1<StoredF32>} _1w
- * @property {SeriesPattern1<StoredF32>} _1m
- * @property {SeriesPattern1<StoredF32>} _1y
+ * @typedef {Object} SeriesTree_Addrs_Reused_Supply
+ * @property {BtcCentsSatsUsdPattern} all
+ * @property {BtcCentsSatsUsdPattern} p2pk65
+ * @property {BtcCentsSatsUsdPattern} p2pk33
+ * @property {BtcCentsSatsUsdPattern} p2pkh
+ * @property {BtcCentsSatsUsdPattern} p2sh
+ * @property {BtcCentsSatsUsdPattern} p2wpkh
+ * @property {BtcCentsSatsUsdPattern} p2wsh
+ * @property {BtcCentsSatsUsdPattern} p2tr
+ * @property {BtcCentsSatsUsdPattern} p2a
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} share
  */
 
 /**
- * @typedef {Object} SeriesTree_Addrs_Exposed
+ * @typedef {Object} SeriesTree_Addrs_Respent
  * @property {FundedTotalPattern} count
- * @property {SeriesTree_Addrs_Exposed_Supply} supply
+ * @property {SeriesTree_Addrs_Respent_Events} events
+ * @property {SeriesTree_Addrs_Respent_Supply} supply
  */
 
 /**
- * @typedef {Object} SeriesTree_Addrs_Exposed_Supply
+ * @typedef {Object} SeriesTree_Addrs_Respent_Events
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} outputToReusedAddrCount
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} outputToReusedAddrShare
+ * @property {_1m1w1y24hBpsPercentRatioPattern} spendableOutputToReusedAddrShare
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6} inputFromReusedAddrCount
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7} inputFromReusedAddrShare
+ * @property {_1m1w1y24hBlockPattern} activeReusedAddrCount
+ * @property {_1m1w1y24hBlockPattern2} activeReusedAddrShare
+ */
+
+/**
+ * @typedef {Object} SeriesTree_Addrs_Respent_Supply
  * @property {BtcCentsSatsUsdPattern} all
  * @property {BtcCentsSatsUsdPattern} p2pk65
  * @property {BtcCentsSatsUsdPattern} p2pk33
@@ -5164,20 +5372,27 @@ function createTransferPattern(client, acc) {
  * @property {BtcCentsSatsUsdPattern} p2wsh
  * @property {BtcCentsSatsUsdPattern} p2tr
  * @property {BtcCentsSatsUsdPattern} p2a
- * @property {SeriesTree_Addrs_Exposed_Supply_Share} share
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} 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
+ * @typedef {Object} SeriesTree_Addrs_Exposed
+ * @property {FundedTotalPattern} count
+ * @property {SeriesTree_Addrs_Exposed_Supply} supply
+ */
+
+/**
+ * @typedef {Object} SeriesTree_Addrs_Exposed_Supply
+ * @property {BtcCentsSatsUsdPattern} all
+ * @property {BtcCentsSatsUsdPattern} p2pk65
+ * @property {BtcCentsSatsUsdPattern} p2pk33
+ * @property {BtcCentsSatsUsdPattern} p2pkh
+ * @property {BtcCentsSatsUsdPattern} p2sh
+ * @property {BtcCentsSatsUsdPattern} p2wpkh
+ * @property {BtcCentsSatsUsdPattern} p2wsh
+ * @property {BtcCentsSatsUsdPattern} p2tr
+ * @property {BtcCentsSatsUsdPattern} p2a
+ * @property {AllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5} share
  */
 
 /**
@@ -6259,7 +6474,7 @@ 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} capitalized
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
@@ -6451,7 +6666,7 @@ function createTransferPattern(client, acc) {
  * @property {BlockChangeCumulativeDeltaSumPattern} netPnl
  * @property {AdjustedRatioValuePattern} sopr
  * @property {BlockCumulativeSumPattern} grossPnl
- * @property {_1m1w1y24hPattern7} sellSideRiskRatio
+ * @property {_1m1w1y24hPattern8} sellSideRiskRatio
  * @property {BlockCumulativeSumPattern} peakRegret
  * @property {PricePattern} capitalized
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
@@ -6574,7 +6789,7 @@ 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} capitalized
  * @property {_1m1w1y24hPattern<StoredF64>} profitToLossRatio
@@ -7007,7 +7222,7 @@ function createTransferPattern(client, acc) {
  * @extends BrkClientBase
  */
 class BrkClient extends BrkClientBase {
-  VERSION = "v0.3.0-beta.3";
+  VERSION = "v0.3.0-beta.5";
 
   INDEXES = /** @type {const} */ ([
     "minute10",
@@ -8532,38 +8747,58 @@ class BrkClient extends BrkClientBase {
             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'),
-              _24h: createSeriesPattern1(this, 'active_reused_addr_share_average_24h'),
-              _1w: createSeriesPattern1(this, 'active_reused_addr_share_average_1w'),
-              _1m: createSeriesPattern1(this, 'active_reused_addr_share_average_1m'),
-              _1y: createSeriesPattern1(this, 'active_reused_addr_share_average_1y'),
-            },
+            activeReusedAddrShare: create_1m1w1y24hBlockPattern2(this, 'active_reused_addr_share'),
+          },
+          supply: {
+            all: createBtcCentsSatsUsdPattern(this, 'reused_addr_supply'),
+            p2pk65: createBtcCentsSatsUsdPattern(this, 'p2pk65_reused_addr_supply'),
+            p2pk33: createBtcCentsSatsUsdPattern(this, 'p2pk33_reused_addr_supply'),
+            p2pkh: createBtcCentsSatsUsdPattern(this, 'p2pkh_reused_addr_supply'),
+            p2sh: createBtcCentsSatsUsdPattern(this, 'p2sh_reused_addr_supply'),
+            p2wpkh: createBtcCentsSatsUsdPattern(this, 'p2wpkh_reused_addr_supply'),
+            p2wsh: createBtcCentsSatsUsdPattern(this, 'p2wsh_reused_addr_supply'),
+            p2tr: createBtcCentsSatsUsdPattern(this, 'p2tr_reused_addr_supply'),
+            p2a: createBtcCentsSatsUsdPattern(this, 'p2a_reused_addr_supply'),
+            share: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(this, 'reused_addr_supply_share'),
+          },
+        },
+        respent: {
+          count: createFundedTotalPattern(this, 'respent_addr_count'),
+          events: {
+            outputToReusedAddrCount: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'output_to_respent_addr_count'),
+            outputToReusedAddrShare: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7(this, 'output_to_respent_addr_share'),
+            spendableOutputToReusedAddrShare: create_1m1w1y24hBpsPercentRatioPattern(this, 'spendable_output_to_respent_addr_share'),
+            inputFromReusedAddrCount: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern6(this, 'input_from_respent_addr_count'),
+            inputFromReusedAddrShare: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern7(this, 'input_from_respent_addr_share'),
+            activeReusedAddrCount: create_1m1w1y24hBlockPattern(this, 'active_respent_addr_count'),
+            activeReusedAddrShare: create_1m1w1y24hBlockPattern2(this, 'active_respent_addr_share'),
+          },
+          supply: {
+            all: createBtcCentsSatsUsdPattern(this, 'respent_addr_supply'),
+            p2pk65: createBtcCentsSatsUsdPattern(this, 'p2pk65_respent_addr_supply'),
+            p2pk33: createBtcCentsSatsUsdPattern(this, 'p2pk33_respent_addr_supply'),
+            p2pkh: createBtcCentsSatsUsdPattern(this, 'p2pkh_respent_addr_supply'),
+            p2sh: createBtcCentsSatsUsdPattern(this, 'p2sh_respent_addr_supply'),
+            p2wpkh: createBtcCentsSatsUsdPattern(this, 'p2wpkh_respent_addr_supply'),
+            p2wsh: createBtcCentsSatsUsdPattern(this, 'p2wsh_respent_addr_supply'),
+            p2tr: createBtcCentsSatsUsdPattern(this, 'p2tr_respent_addr_supply'),
+            p2a: createBtcCentsSatsUsdPattern(this, 'p2a_respent_addr_supply'),
+            share: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(this, 'respent_addr_supply_share'),
           },
         },
         exposed: {
           count: createFundedTotalPattern(this, 'exposed_addr_count'),
           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'),
-            },
+            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'),
+            share: createAllP2aP2pk33P2pk65P2pkhP2shP2trP2wpkhP2wshPattern5(this, 'exposed_addr_supply_share'),
           },
         },
         delta: {
@@ -9409,7 +9644,7 @@ 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'),
               capitalized: createPricePattern(this, 'capitalized_price'),
               profitToLossRatio: create_1m1w1y24hPattern(this, 'realized_profit_to_loss_ratio'),
@@ -9546,7 +9781,7 @@ 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'),
               capitalized: createPricePattern(this, 'sth_capitalized_price'),
               profitToLossRatio: create_1m1w1y24hPattern(this, 'sth_realized_profit_to_loss_ratio'),
@@ -9649,7 +9884,7 @@ 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'),
               capitalized: createPricePattern(this, 'lth_capitalized_price'),
               profitToLossRatio: create_1m1w1y24hPattern(this, 'lth_realized_profit_to_loss_ratio'),
@@ -10403,63 +10638,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
    *
@@ -10842,6 +11020,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.3"
+  "version": "0.3.0-beta.5"
 }