Skip to main content
Borrow a Morpho Blue market’s loan asset against supported collateral, or add collateral and borrow in a single transaction batch. The user’s wallet owns the position and receives the loan proceeds. Earn deposits and borrow positions are separate: depositing into an earn vault does not provide collateral for borrowing.
Launch preview. The examples below describe the upcoming Morpho Borrow release at https://api.base.org/earn/v1.

​
Collateral, Debt, and Liquidation

A Morpho Blue market defines its collateral token, loan token, oracle, interest-rate model and liquidation loan-to-value threshold (LLTV). Read the selected market’s terms rather than hardcoding a collateral pair or threshold. LTV is debt value divided by collateral value. Debt includes the financed origination fee and increases as interest accrues. Changes in collateral value can make a position liquidatable. Show current risk and leave a buffer below the liquidation threshold.

​
Select a Market

Use the productId, debtMarketAssetId and, when adding collateral, collateralMarketAssetId supplied for your supported Morpho Blue market on Base. These are API identifiers, not token addresses or onchain market IDs. A lend vaultId cannot be used here. The Borrow endpoint does not list markets or read positions. Before integrating, obtain the supported market identifiers and token decimals for your app, and connect a position-data source for current collateral, debt and risk.

​
Origination Fee

Each borrow has a fixed 25 bps (0.25%) origination fee, calculated on the net proceeds and rounded down in loan-token atomic units. The fee is financed into the debt; it is not deducted from the requested net proceeds. Interest accrues on the gross borrowing. Fee overrides and additional recipients are not accepted.
Fee calculation
See Borrow for the request fields and the fee fields in the response.

​
End-to-End: Morpho Borrow

1

Select a market

Select a supported market and load the user’s current collateral, debt and risk. Confirm the wallet supports atomic execution on Base.
2

Choose amounts

Let the user choose the net loan amount and, optionally, collateral to add. Show the fee, gross borrowing and liquidation risk.
3

Request a batch

Request a fresh batch from POST /borrow/morpho/transact, including your builderCode. Check the returned economics against the amounts shown to the user.
4

Execute atomically

Ask the user’s wallet to approve and execute the complete batch atomically. Use the wallet execution example, which forwards the attribution suffix and disables sequential fallback.
5

Refresh and monitor

Wait for successful execution, then refresh the position and loan-token balance. Continue showing accrued debt and liquidation risk.

​
Position Management and Repayment

This release covers borrowing against existing collateral and adding collateral with borrowing. It does not add Base Earn endpoints for position reads, repayment, standalone collateral deposits or collateral withdrawals. Connect those capabilities through a separate Morpho integration (see the Morpho documentation) before offering borrowing to users. A complete user experience must include position monitoring and a working repayment path. To close a position, account for accrued interest and repay outstanding debt before withdrawing the remaining collateral. Do not use the original netAmount as the repayment amount. Refresh position data after each confirmed action and treat missing risk data as unavailable, not as zero risk.