Redeem lend at maturity
Redeem Midnight credit at maturity for the loan token, using SDK or raw contract flows to read the position and complete settlement.
Read the position
Public APIThe REST API is the quickest way to inspect the position. It returns the stored, indexed values and can lag a few blocks. To size the transaction, run the SDK read or the direct contract read: they return the live, accrued values that the next steps use.
Fetch the lender's position to get the credit available to redeem:
GET https://api.morpho.org/v0/midnight/markets
/{marketId}/users/{userAddress}/position
// Response
{
"data": {
"chain_id": 8453,
"market_id": "0xd92de5e7fbb...7614", // market the lender lent into
"user_address": "0xYourWalletAddress",
"last_indexed_block": "47457420",
"loan_token": "0x8335...2913", // USDC
"maturity": "1798761600",
"type": "lend", // "lend" | "borrow" | "collateral_only"
"credit": "10500000000", // stored credit - the redeemable amount comes from the accrued read in the Onchain tab
"debt": "0",
"pending_fee": "12000", // accrued fee, nets out of the payout
"last_loss_factor": "0", // loss factor already applied to this position
"loss_factor": "0", // current market loss factor (applies to credit on bad debt)
"collaterals": [] // lenders post no collateral
}
}
// Inspection only - size the transaction from the Morpho SDK or Onchain tab.Endpoint references:
The SDK reads the accrued position through midnight.getPositionData:
import { publicActions } from "viem";
import { morphoViemExtension } from "@morpho-org/morpho-sdk";
// Extend the wallet client with the `morpho` namespace and the public reads
// the flow needs (getBlock / waitForTransactionReceipt).
const client = walletClient.extend(morphoViemExtension()).extend(publicActions);
const midnight = client.morpho.midnight(8453); // Midnight entity for Base
// marketId = the market's id - from the Morpho API tab or the markets endpoint
// Fetch the position and accrue it to the current block's timestamp.
const block = await client.getBlock();
const positionData = (
await midnight.getPositionData({
marketId,
accountAddress: lender,
parameters: { blockNumber: block.number },
})
).accrueInterest(block.timestamp);
// positionData.faceValue = accrued credit net of accrued pending fee - the
// full-redemption units the redeem flow defaults to (same as newCredit minus
// newPendingFee in the direct contract read in the Onchain tab).
// Redemption is bounded by the market's withdrawable liquidity - the bound
// the redeem flow checks. Cap the full redemption at it.
const units =
positionData.faceValue < positionData.market.withdrawable
? positionData.faceValue
: positionData.market.withdrawable;
if (units === 0n) throw new Error("no withdrawable liquidity yet, retry later");import { createPublicClient, http } from "viem";
import { base } from "viem/chains";
import { midnightAbi } from "@morpho-org/morpho-sdk/abis";
const MIDNIGHT = "0xAdedD8ab6dE832766Fedf0FaC4992E5C4D3EA18A"; // Midnight on Base (from the @morpho-org/morpho-ts address registry)
const publicClient = createPublicClient({ chain: base, transport: http() });
// market = the Market struct - from GET /v0/midnight/markets/{marketId} or a prior browse step
// A full redemption uses the accrued redeemable credit - the same value the
// SDK redeems by default (positionData.faceValue): newCredit minus the accrued
// pending fee.
const [newCredit, newPendingFee] = await publicClient.readContract({
address: MIDNIGHT,
abi: midnightAbi,
functionName: "updatePositionView",
args: [market, marketId, lender],
});
// The market's withdrawable liquidity in units - the bound Midnight.withdraw
// enforces (the same value the SDK's redeem flow checks).
const withdrawable = await publicClient.readContract({
address: MIDNIGHT,
abi: midnightAbi,
functionName: "withdrawable",
args: [marketId],
});
const units =
newCredit - newPendingFee < withdrawable ? newCredit - newPendingFee : withdrawable;
if (units === 0n) throw new Error("no withdrawable liquidity yet, retry later");Redeem
Private APIYou can redeem with the Morpho SDK: its redeem flow checks the accrued position for you and builds a direct Midnight.withdraw transaction - no bundle and no requirements. Redemption is bounded by the market's withdrawable liquidity - the SDK throws InsufficientMidnightWithdrawableLiquidityError above it. A partial redemption leaves the rest redeemable later. The Contract call tab shows the manual equivalent.
Use Build a quoted Midnight credit withdrawal with amount.unit: "all" for direct redemption of accrued credit at maturity. This mode takes no offers and accepts no price guard or referral fee. It is not the early-exit sell flow.
Use a Base market whose loan token is USDC. Set MIDNIGHT_MARKET_SELECTOR to 8453:MARKET_ID from the read step and replace the public test account below with the connected wallet. Amounts are integer strings in token base units. Keep $MORPHO_API_KEY on your backend. Select the matured market.
curl --silent --show-error --include \
--request POST \
"https://private.api.morpho.org/v0/actions/midnight/markets/$MIDNIGHT_MARKET_SELECTOR/withdraw" \
--header "x-api-key: $MORPHO_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"account": "0x4f620E5a62Eb51DA77502E8d3De7DB41f43e5695",
"amount": {
"unit": "all"
}
}'| Response field | Check before sending |
|---|---|
data.status, data.action | Require prepared and midnight.redeem. |
data.simulation.status | Require success; a failed simulation has no executable calls. |
data.calls | Inspect targets, calldata, values, and approvals; preserve order. |
data.resolved_amount | Check the actual accrued credit units redeemed. |
data.simulation.effects, data.simulation.position_changes | Check redeemed_assets, redeemed_units, and the expected credit reduction. |
Do not send an error response or a simulation_failed result. The user's wallet sends the returned calls, in order, only after checking the simulation and verifying the signed proof, with user approval. Morpho does not submit transactions.
Without partial redemption, insufficient market liquidity returns INSUFFICIENT_LIQUIDITY. To redeem only currently available liquidity, add allow_partial: true with unit: "all" and check the actual resolved amount; this can leave a position. Zero credit returns POSITION_EMPTY. Do not include allow_partial with exact asset or unit amounts.
Hand the flow the accrued positionData from the Morpho SDK tab in “Read the position”:
// `client`, `midnight`, `positionData` and `units` come from the SDK
// `positionData` and `units` come from the Morpho SDK tab in Read the position.
const redeem = midnight.redeem({
accountAddress: lender,
positionData,
receiver: lender,
units,
});
// `redeem` returns no requirements and checks the accrued credit plus the
// market's withdrawable liquidity; `receiver` defaults to the owner and
// `units` is passed explicitly, already capped at withdrawable.
// The built transaction is a direct Midnight.withdraw call.
const hash = await client.sendTransaction(redeem.buildTx());
console.log("Redeem tx:", hash);See Position maintenance for the full surface.
Call Midnight.withdraw directly:
// `midnightAbi`, `MIDNIGHT`, `market` and `units` come from the Onchain tab
// in Read the position.
const hash = await walletClient.writeContract({
account: lender,
address: MIDNIGHT,
abi: midnightAbi,
functionName: "withdraw",
args: [
market, // Market struct
units, // credit units to redeem
lender, // onBehalf - whose credit is reduced
lender, // receiver - where the loan tokens go
],
});
// The call debits credit and the market's withdrawable liquidity - not
// gated on maturity; pre-maturity it succeeds only up to withdrawable -
// and redeems 1:1 net of accrued fees and losses.
console.log("Redeem tx:", hash);Borrow at a fixed rate
Build a Midnight borrower flow that finds markets, quotes an offer, authorizes the transaction, and borrows at a fixed rate.
Exit borrow at maturity
Close a Midnight borrow at maturity by reading debt and collateral, repaying the full balance, and withdrawing collateral through SDK or contract calls.