How to quote for a new loan

Overview

Before implementing loan features in your application, you'll need to retrieve essential loan information such as interest rates, minimum collateral requirements, and other terms. This guide explains how to fetch this data using our Protocol Data API endpoints.

Two Integration Approaches

A) Protocol-Specific Approach (Explicit)

Use this when you want to work with a specific lending protocol.

1. Get Available Protocols First, retrieve the list of all supported protocols:

   GET /strategies

2. Query Protocol Details Then, fetch specific protocol information using:

   GET /strategies/:id

   Required Parameters:

   Parameter	Description	Example
   action	Type of operation	borrow
   chainId	Blockchain network ID	137 (Polygon)
   protocol	Protocol name	aave
   amount	Borrow amount	10000000 (with decimals)
   asset	Asset to borrow	USDC
   collateralAsset	Collateral asset	ETH
   collateralAmount	Amount of collateral	900000000000000000000000 (0.009 ETH with decimals)

   Example Request:

   GET /strategies/aave?action=borrow&chainId=137&protocol=aave&amount=10000000&asset=USDC&collateralAsset=ETH&collateralAmount=900000000000000000000000

   Response includes:

   • Current interest rate

   • Liquidation price

   • Loan-to-Value (LTV) ratio

   Example Response:

   {
     "status": "success",
     "data": {
       "protocol": "aave",
       "position": {
         "borrowAmount": "10000000",  // 10000000 with decimals
         "borrowAsset": "USDC",
         "collateralAmount": "900000000000000000000000",  // 0.009 ETH with decimals
         "collateralAsset": "ETH",
         "interestRate": "3.5",
         "liquidationPrice": "1850.00",
         "ltv": "75.5",
         "healthFactor": "1.85"
       },
       "marketConditions": {
         "maxLTV": "80.0",
         "liquidationThreshold": "82.5",
         "availableLiquidity": "1000000"
       }
     }
   }

B) Protocol-Agnostic Approach (Less Explicit)

Let our system automatically select the optimal protocol for your needs.

1. Use the Generic Endpoint

   GET /strategies/0x0

   Use the same parameters as above, excluding protocol.

   Our system will analyze your requirements and return the best protocol option based on:

   • Lowest interest rates

   • Best LTV ratios

   • Current market conditions

   • Protocol reliability

UI Integration Example

Example UI implementation showing protocol selection

Next Steps

After retrieving protocol information, you can proceed to:

• Execute a loan
• Manage loan positions