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.Routes
Paths below start with/api/v1/lending. All use GET.
pool_id is a positive decimal uint64. Use the chain denom, not the display token symbol, and percent-encode it in a path.
Malformed parameters return 400; absent pool/asset resources return 404; database failures return 500. These reference lists are not paginated.
Units and availability
Asset caps, balances and liquidity use raw denom base-unit strings; shares use raw share units. APYs, per-second rates, utilization, LTV, thresholds and deviation bounds are decimal ratios. Asset-curverates instead uses annual basis points, for example "1000" means 10% annual
before the model’s utilization interpolation. kinks contains utilization ratios.
rates is always a response key but can be null when the indexed curve is absent or stored as
JSON null. Treat a missing curve as unavailable data until a later response supplies it.
An explicit array, including [], is different from null. Do not infer zero interest from missing
curve data or reconstruct it from legacy slopes. Accounting remains readable, while the asset-state
per-second rate and APY fields stay null until the curve is available. maxOracleStalenessMicroseconds is a duration in microseconds, even though response timestamps use milliseconds.
totalSupplyAssets and totalBorrowAssets include indexed accrual. They are not separate principal and interest balances. availableLiquidityAssets constrains exits independently of a supplier’s share balance. APYs can be null when they cannot be calculated; a missing observation is not a zero yield.
AssetOracle exposes the feed chosen for this pool asset, its source observation time, and stale, marketOpen, bridgeActive. Use it with the pool’s checks rather than treating receipt of any price as permission to borrow or liquidate. The broader feed registry is Oracle Prices.
Response field reference
Types below describe JSON, not numeric units. See the unit notes above. Nullable values must not be replaced with zero.Params
Params
PoolSummary
PoolSummary
Pool
Pool
AssetSummary
AssetSummary
Asset
Asset
AssetState
AssetState
AssetOracle
AssetOracle