[645] Create amm tvl metrics (liquidity_pools_tvl) in tvl_agg

Author: taha-aziz

models/docs/marts/tvl/tvl_agg.md

@@ -12,6 +12,10 @@ The total value locked (TVL) denominated in raw asset value (token amounts) for
 The total value locked (TVL) denominated in raw asset value (token amounts) for a given date. Aggregated across trustlines selling liabilities
 {% enddocs %}
 
+{% docs liquidity_pools_tvl %}
+The total value locked (TVL) denominated in raw asset value (token amounts) for a given date. Aggregated across liquidity pool balances (AMM).
+{% enddocs %}
+
 {% docs total_tvl %}
-The total value locked (TVL) denominated in raw asset value (token amounts) for a given date. Aggregated across relevant ledger entries (e.g., accounts, trustlines).
+The total value locked (TVL) denominated in raw asset value (token amounts) for a given date. Aggregated across relevant ledger entries (e.g., accounts, trustlines, liquidity pools).
 {% enddocs %}

models/marts/tvl/tvl_agg.sql

@@ -33,21 +33,40 @@ with
         group by 1, 2, 3, 4
     )
 
+    , liquidity_pools_tvl as (
+        select
+            day
+            , asset_type
+            , asset_code
+            , asset_issuer
+            , sum(liquidity_pool_balance) as liquidity_pools_tvl
+        from {{ ref('asset_balances__daily_agg') }}
+        group by 1, 2, 3, 4
+    )
+
     , combined as (
         select
-            coalesce(a.day, t.day) as day
-            , coalesce(a.asset_type, t.asset_type) as asset_type
-            , coalesce(a.asset_code, t.asset_code) as asset_code
-            , coalesce(a.asset_issuer, t.asset_issuer) as asset_issuer
+            coalesce(a.day, t.day, l.day) as day
+            , coalesce(a.asset_type, t.asset_type, l.asset_type) as asset_type
+            , coalesce(a.asset_code, t.asset_code, l.asset_code) as asset_code
+            , coalesce(a.asset_issuer, t.asset_issuer, l.asset_issuer) as asset_issuer
             , coalesce(a.accounts_tvl, 0) as accounts_tvl
             , coalesce(t.trustlines_tvl, 0) as trustlines_tvl
-            , coalesce(a.accounts_tvl, 0) + coalesce(t.trustlines_tvl, 0) as total_tvl
+            , coalesce(l.liquidity_pools_tvl, 0) as liquidity_pools_tvl
+            , coalesce(a.accounts_tvl, 0)
+            + coalesce(t.trustlines_tvl, 0)
+            + coalesce(l.liquidity_pools_tvl, 0) as total_tvl
         from accounts_tvl as a
         full outer join trustlines_tvl as t
             on a.day = t.day
             and a.asset_type = t.asset_type
             and a.asset_code = t.asset_code
             and a.asset_issuer = t.asset_issuer
+        full outer join liquidity_pools_tvl as l
+            on coalesce(a.day, t.day) = l.day
+            and coalesce(a.asset_type, t.asset_type) = l.asset_type
+            and coalesce(a.asset_code, t.asset_code) = l.asset_code
+            and coalesce(a.asset_issuer, t.asset_issuer) = l.asset_issuer
     )
 
 select *

models/marts/tvl/tvl_agg.yml

@@ -2,7 +2,7 @@ version: 2
 
 models:
   - name: tvl_agg
-    description: "This table aggregates TVL from accounts and trustlines to calculate total TVL"
+    description: "This table aggregates TVL from accounts, trustlines, and liquidity pools to calculate total TVL"
     tests:
       - elementary.schema_changes:
           tags: [schema_changes]
@@ -59,6 +59,13 @@ models:
               date_column_name: "day"
               greater_than_equal_to: "2 day"
 
+      - name: liquidity_pools_tvl
+        description: '{{ doc("liquidity_pools_tvl") }}'
+        tests:
+          - stellar_dbt_public.incremental_not_null:
+              date_column_name: "day"
+              greater_than_equal_to: "2 day"
+
       - name: total_tvl
         description: '{{ doc("total_tvl") }}'
         tests: