Skip to main content
Testnet-Only. Use https://test-dex-api.cloud.aultblockchain.xyz for these endpoints and the matching Testnet chain for signed actions. This product is not available on Mainnet.
Read supplied shares, collateral, debt, health and liquidation history. Lending supply and collateral are separate balances. For the health formula and liquidation rules, see Lending.

​
Routes

All routes use GET under /api/v1/lending. Use bech32 or EVM hex for wallet addresses and the returned bech32 account address for derived borrowers. Pool IDs are positive decimal integers. Position history uses positive millisecond bounds [from, to): include from, exclude to. It has no cursor. Hourly points are returned oldest first. With interval=1d, each point keeps the last available hourly snapshot from that UTC day and labels it at 00:00 UTC, rather than averaging the day. A day whose midnight is before from is excluded even when later hourly data falls inside the requested window; align bounds to UTC midnights for whole-day results. The liquidation feed also accepts paired before_height and before_index. See Pagination for limits and continuation. Invalid parameters return 400. A missing single pool/position resource returns 404; empty collections return empty arrays.

​
Position amounts and health

supplies and borrows contain {denom, shares, assets}; collaterals contains {denom, amount}. Asset amounts are raw denom base units, debt includes accrued interest, and shares are not token balances. Health valuation totals use the implementation’s raw-amount times oracle-price scale. Do not display them as unscaled human USD or mix them with normalized Perp equity. Ratios such as healthFactor are dimensionless. For an 18-decimal Core asset, raw 1000000000000000000 is one token. At oracle price "2", its raw-scale valuation is "2000000000000000000"; convert that scale before displaying two USD. asOf, indexedHeight and oracleUpdatedAt describe the view. If any required asset cannot be priced, healthError is set and derived health/value fields become null. Do not treat unavailable health as a safe account or a liquidatable account. liquidatable is nullable for this reason.

​
Position and liquidation history

Liquidation rows record repaid and seized {denom, amount} values in raw units, plus the block/event position. Deficits and insurance balances help assess pool risk; they do not guarantee available loss coverage.

​
Response field reference

Types below describe JSON, not numeric units. See the unit notes above. Nullable values must not be replaced with zero.