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

[taha-aziz]

PR Checklist

PR Structure

• This PR has reasonably narrow scope (if not, break it down into smaller PRs).
• This PR avoids mixing refactoring changes with feature changes (split into two PRs
  otherwise).
• This PR's title starts with the jira ticket associated with the PR.

Thoroughness

• This PR adds tests for the most critical parts of the new functionality or fixes.
• I've updated the docs and README with the added features, breaking changes, new instructions on how to use the repository.

Release planning

• I've decided if this PR requires a new major/minor/patch version accordingly to
  semver, and I've changed the name of the BRANCH to major/* , minor/* or patch/* .

What

https://github.com/stellar/stellar-dbt/issues/645

Why

SDF is taking over reporting TVL of our AMM from Lumenswap. This PR creates the liquidity_pools_tvl which is the raw asset balance of each asset locked for AMM.

Currently, tvl_agg only tracks DEX orderbook TVL via selling_liabilities from accounts (XLM) and trustlines (non-XLM). It completely misses AMM/liquidity pool TVL — the actual token amounts locked in pools. The asset_balances__daily_agg model already computes liquidity_pool_balance per asset per day (sourced from int_account_balances__liquidity_pools, which decomposes pool shares into underlying asset amounts). We're pulling this column into tvl_agg as a new liquidity_pools_tvl column.

Known limitations

We will have to fully rebuild our tvl_agg model to include this new column so it has it historically

[Copilot]

Pull request overview

Adds AMM/liquidity pool TVL into the existing tvl_agg mart so downstream reporting can include assets locked in Stellar AMM pools (in raw token amounts), not just DEX orderbook selling-liabilities TVL.

Changes:

• Adds a new liquidity_pools_tvl metric sourced from asset_balances__daily_agg.liquidity_pool_balance.
• Updates tvl_agg to include liquidity_pools_tvl and incorporate it into total_tvl.
• Extends schema + docs to describe and test the new column.

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
models/marts/tvl/tvl_agg.sql	Adds AMM TVL CTE and joins it into the aggregated TVL output.
models/marts/tvl/tvl_agg.yml	Updates model description and adds schema tests for liquidity_pools_tvl.
models/docs/marts/tvl/tvl_agg.md	Adds documentation block for liquidity_pools_tvl and updates total_tvl docs.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[amishas157]

Looks good to me

[amishas157]

@taha-aziz Can you also rebase against latest release-v20260407

I pushed some changes, recency tests should look differently https://github.com/stellar/stellar-dbt-public/blob/release-v20260407/models/marts/tvl/tvl_agg.yml