> For the complete documentation index, see [llms.txt](https://delpho.gitbook.io/delpho-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://delpho.gitbook.io/delpho-docs/for-developers/read-functions.md).

# Read functions

This page describes the public read API for Delpho contracts.

\[PENDING: full ABI documentation to be populated from the deployed contract source.]

## USDV token

Standard ERC-20 read functions:

* `balanceOf(address)` — USDV balance for an address.
* `totalSupply()` — total USDV in circulation.
* `decimals()` — 18.

## sUSDV staking

* `balanceOf(address)` — sUSDV balance for an address.
* `totalSupply()` — total sUSDV in circulation.
* `pricePerShare()` — current USDV value of 1 sUSDV. Used to compute the dollar value of an sUSDV position.
* `totalUnderlying()` — total USDV held by the staking contract.

## Mint orchestrator

* `getCollateralPosition(address user, address collateral)` — returns the user's collateral balance, debt amount, and current LTV for a specific collateral type.
* `getMaxMint(address user, address collateral, uint256 collateralAmount)` — returns the maximum USDV mintable for a given collateral deposit.
* `getLiquidationPrice(address user, address collateral)` — returns the collateral price at which the user's position would hit the liquidation threshold.
* `getHealthFactor(address user, address collateral)` — returns the user's current health factor.

## Treasury

* `getReserveBalance()` — current treasury reserve in USDV terms.
* `getCollateralizationRatio()` — total collateral value divided by total USDV supply.

## Per-collateral configuration

For each collateral type:

* `getMaxLTV(address collateral)` — the maximum mint LTV.
* `getLiquidationThreshold(address collateral)` — the liquidation threshold.
* `getOracle(address collateral)` — the oracle address used for price.
* `getCollateralCap(address collateral)` — the per-collateral debt cap.