v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

lendborrow

Withdraw With Approval

Process the withdrawal of deposited assets from a lending protocol with automated approval handling. Returns an array of transactions: an ERC-20 approval transaction (only when required) followed by the withdrawal transaction. This eliminates the need for manual allowance management before withdrawal.

💡 Compute Unit Value: 205 (Fixed)

post/defi/v1/lendborrow/withdraw-with-approval

Request body

lendborrowId'1000' | '1003' | '1005' | '1200' | '1208' | '1203' | '1204' | '1205' | '1206' | '1207' | '1100' | '1300' | '1302' | '1400' | '1401' | '1402' | '1403' | '1404'

The unique ID to specify the lending and borrowing protocol for routing relevant queries or transactions.

assetstring

Token address of the asset to withdraw.

amountstring required

Number of tokens to be withdrawn.

tostring required

Public address of the recipient who will receive the tokens.

fromstring required

Public address of the sender initiating the transaction.

gasstring

Maximum gas to be approved for the transaction.

gasPrioritystring

Specifies the priority level for gas fees (e.g., 'low', 'medium', or 'high'), which influences the transaction speed and cost.

enableFeeboolean

Flag to include a basis points fee transaction alongside the main transaction when set to true.

batchOption'EIP-5792' | 'EIP-7702'

The batch option to be used for the transaction.

batcherContractstring

The EOA address of the batcher that will be used to execute the transaction when using EIP-7702 batching. If not provided, the default batcher contract for the chain will be used.

useCustomVaultsboolean

A boolean flag to scope the API request. If true, the request will be processed using the partner's dedicated vaults. If false or omitted, it uses the standard public pools.

marketstring

The market of the asset, such as USDC or WETH. Defaults to USDC.

marketIdstring

Specifies the market Id of any market in Morpho.

vaultAddressstring

Specifies the vaultAddress of any vault in Morpho.

onBehalfOfstring

Public address of the user on whose behalf the borrow action will be executed.

collateralboolean

Specifies the condition for depositing the token as a supply to earn the yields only or use it as collateral to borrow loan asset.

Example request

{
  "lendborrowId": "1000",
  "asset": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "amount": "10000",
  "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "gas": "100000",
  "gasPriority": "low",
  "enableFee": false,
  "batchOption": "EIP-5792",
  "batcherContract": "0x9c933f9d2efd76ce25b0d3dde84d3f94e78a50ca",
  "useCustomVaults": false,
  "market": "USDC",
  "marketId": "0x3b3769cfca57be2eaed03fcc5299c25691b77781a1e124e7a8d520eb9a7eabb5",
  "vaultAddress": "0xa258C4606Ca8206D8aA700cE2143D7db854D168c",
  "onBehalfOf": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "collateral": false
}

Response

Successful response

statusnumber

Numeric status code indicating success or failure of the API call

msgstring

Human-readable message describing the API result or error

Example response

{
  "status": 200,
  "msg": "success",
  "data": [
    {
      "chainId": "1",
      "from": "0x829bFB482331b9Dc2BEcb5483ecA79c0578c3A45",
      "to": "0x98C23E9d8f34FEFb1B7BD6a91B7FF122F4e16F5c",
      "gas": "51692",
      "value": "0",
      "data": "0x095ea7b300000000000000000000000054d9abeed8415446f8c736d198a8797156b41a93000000000000000000000000000000000000000000000000002386f26fc10000",
      "referenceId": "878b54fb5a674e4db5de982600669fce"
    },
    {
      "chainId": "1",
      "from": "0x829bFB482331b9Dc2BEcb5483ecA79c0578c3A45",
      "to": "0x54d9ABeed8415446F8C736D198a8797156b41a93",
      "gas": "500000",
      "value": "0",
      "data": "0xb460af94000000000000000000000000000000000000000000000000002386f26fc10000000000000000000000000000829bfb482331b9dc2becb5483eca79c0578c3a45000000000000000000000000829bfb482331b9dc2becb5483eca79c0578c3a45",
      "referenceId": "878b54fb5a674e4db5de982600669fce"
    }
  ]
}