v1

latestOpenAPI 3.1.02026-07-24223580832.9 KB

lendborrow

Borrow

Initiates a borrowing transaction for a specified amount of tokens from supported lending markets (Aave V2/V3, Compound V2/V3), allowing configuration of asset, amount, interest rate mode, on-behalf-of address, and gas parameters for an optimized borrowing process.

💡 Compute Unit Value: 225 (Fixed)

post/defi/v1/lendborrow/borrow

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 required

The token address of the asset to borrow.

amountstring required

The number of tokens to borrow.

interestRateModestring required

Interest mode as per Aave. Use 0 for static and 1 for variable.

onBehalfOfstring required

Public address of the user on whose behalf the borrow 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.

marketstring

Asset market, such as USDC or WETH. Defaults to USDC if not provided.

marketIdstring required

Specifies the market Id of any market in Morpho.

tostring required

Address of the token recipient.

Example request

{
  "lendborrowId": "1000",
  "asset": "0xC02aaA39b223FE8D0A0e5C4F27eAD9083C756Cc2",
  "amount": "10000",
  "interestRateMode": "1",
  "onBehalfOf": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "from": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402",
  "gas": "100000",
  "gasPriority": "low",
  "enableFee": false,
  "market": "USDC",
  "marketId": "0x3b3769cfca57be2eaed03fcc5299c25691b77781a1e124e7a8d520eb9a7eabb5",
  "to": "0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402"
}

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": "0xa415bcad00000000000000000000000065afadd39029741b3b8f0756952c74678c9cec93000000000000000000000000000000000000000000000000000000000000006400000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000000000000000000000000000000829bfb482331b9dc2becb5483eca79c0578c3a45",
    "referenceId": "4fab595487904774a12c2555d9ba02a1"
  }
}