Skip to main content
Every Borrow integration shares the same three objects: a market you supply collateral to and borrow from, a position that tracks your account across markets, and an action that moves a position from one state to another.

​
Markets

A market is one loan asset paired with its accepted collateral, on one network, behind one integration. Its type is either pool, a shared pool where every eligible asset can be collateral (Aave, SparkLend), or isolated, a single collateral and loan asset pair (Morpho Blue, Lista). Each market has a loanToken and one or more collateralTokens. Every collateral token carries maxLtv (the maximum loan-to-value ratio it supports), liquidationThreshold (the LTV at which the position becomes liquidatable), liquidationPenalty, and supplyRate (the rate the collateral earns while deposited). The market itself carries borrowRate, availableLiquidity, utilizationRate, isBorrowEnabled, and minLoan (the minimum outstanding debt, set on Lista markets; null where no minimum applies). Rates are decimals: "0.0567" means 5.67%. Discover markets with GET /v1/markets, scoped to your project by default (scope=enabled); pass scope=all for every market the integration exposes. See Coverage for the integrations and networks behind these markets.

​
Positions

GET /v1/positions returns one account’s state for an integrationId, network, and address: total supplied, collateral, and borrowed value in USD, an account-level healthFactor, and a supplyBalances/debtBalances breakdown per market. healthFactor is Σ(collateralUsd × liquidationThreshold) / totalBorrowedUsd. Above 1 the position is safe, at 1 it sits at the liquidation threshold, and below 1 it is liquidatable.
Account-level healthFactor and availableToBorrowUsd are always null for isolated-market integrations (Morpho Blue, Lista), because risk is per-market, not per-account. Read positionState.healthFactor and positionState.availableToBorrowUsd on each supplyBalances entry instead.
Each balance carries pendingActions: the actions available on it next (for example repay, withdraw, or toggle collateral), each with pre-filled args you can pass straight into POST /v1/actions. For Morpho Blue, a position that reaches full liquidation stops appearing in GET /v1/positions and shows up only in GET /v1/positions/liquidations, a paginated liquidation history for the borrower address.

​
Actions

POST /v1/actions moves a position between states. The actions available to a market come from its integration and market type: GET /v1/integrations returns the exact actions and argument schemas available to your project for each integration: treat it as authoritative over this table for a given project. An action response can include preview metadata, which is optional in the response: predictedHealthFactor and predictedLtv show the position after the action settles, alongside the currentHealthFactor and currentLtv before it. When an action needs more than one transaction (for example an approval before a supply), all of them come back together in transactions[]: sign and submit each in order.
On Lista, a market’s minLoan is the smallest debt the market allows. A borrow that would leave debt below it, or a partial repay that would leave dust below it, fails; use repayAll to close the position instead of a partial repay near the minimum.

​
Next steps

Execute a Borrow action

Find a market, request an action, sign and submit, and check the position.

Coverage

The integrations, market types, and networks behind these markets.