v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

lendborrow

Deposit

Facilitate the deposit of assets into lending protocols by specifying the asset, deposit amount, and optionally, a recipient address. This endpoint is designed for users to start earning interest or to use their deposited collateral for borrowing. Gas optimization settings ensure that the deposit transaction is both efficient and cost‐effective.

💡 Compute Unit Value: 230 (Fixed)

post/defi/v1/lendborrow/deposit

Request body

lendborrowId'1000' | '1003' | '1005' | '1200' | '1202' | '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 deposit.

amountstring required

Number of tokens to deposit.

onBehalfOfstring required

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

fromstring required

Sender's public address.

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.

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.

tostring

Receiver's public address.

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.

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",
  "onBehalfOf": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "gas": "100000",
  "gasPriority": "low",
  "enableFee": false,
  "useCustomVaults": false,
  "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "market": "USDC",
  "marketId": "0x3b3769cfca57be2eaed03fcc5299c25691b77781a1e124e7a8d520eb9a7eabb5",
  "vaultAddress": "0xa258C4606Ca8206D8aA700cE2143D7db854D168c",
  "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": "0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2",
    "value": "0",
    "gas": "408298",
    "estimationCheck": true,
    "data": "0xe8eda9df00000000000000000000000065afadd39029741b3b8f0756952c74678c9cec93000000000000000000000000000000000000000000000000002386f26fc10000000000000000000000000000829bfb482331b9dc2becb5483eca79c0578c3a450000000000000000000000000000000000000000000000000000000000000000",
    "referenceId": "7fb853868e4749879ef57d96aae5b9a2"
  }
}