Crypto-Backed Loans

Crypto-Backed Loans lets users post crypto as collateral and borrow against it, through Aave V3, Morpho Blue or Euler V2. One call supplies the collateral and borrows in a single transaction. Another repays and withdraws. The API tracks collateral, debt, rates and the health factor, so you can show users where they stand. Loans run on Ethereum, Base, Arbitrum, HyperEVM and BNB Smart Chain. Not every protocol is on every chain. See Supported Chains.

Before you start

An API key. See the Quick Start.
A Credit Account for the user on the chain you want, holding the collateral token. See Create an Account and Fund an Account.

1. Pick a market

Every request names the lending protocol with protocol. It defaults to AAVE.

Protocol	How you name the market	Find markets with
`AAVE` (default)	Token symbols: `collateral_token` and `borrow_token`.	`GET /v2/earn/aave_markets`: supply and borrow rates per token.
`MORPHO`	A `market_id`. Each market pairs one collateral token with one loan token.	`GET /v2/credit/morpho_markets`: `market_id`, `lltv`, `borrow_apy` and liquidity.
`EULER`	Two vault addresses: `collateral_vault` and `borrow_vault`.	`GET /v2/credit/euler_markets`: each borrow vault, the collateral vaults it accepts, and their LTVs.

For example, list the Aave markets on Base:

curl "https://api.compasslabs.ai/v2/earn/aave_markets?chain=base" \
  -H "x-api-key: $COMPASS_API_KEY"

2. Borrow

Supply 1,000 USDC as collateral and borrow 0.2 WETH on Aave, in one transaction:

import httpx

response = httpx.post(
    "https://api.compasslabs.ai/v2/credit/borrow",
    json={
        "owner": "0xYourWalletAddress",
        "chain": "base",
        "token_in": "USDC",
        "amount_in": "1000",
        "collateral_token": "USDC",
        "borrow_token": "WETH",
        "borrow_amount": "0.2",
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)
result = response.json()

# result["transaction"]: unsigned tx that supplies the collateral and borrows

const response = await fetch("https://api.compasslabs.ai/v2/credit/borrow", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    owner: "0xYourWalletAddress",
    chain: "base",
    token_in: "USDC",
    amount_in: "1000",
    collateral_token: "USDC",
    borrow_token: "WETH",
    borrow_amount: "0.2",
  }),
});
const result = await response.json();

// result.transaction: unsigned tx that supplies the collateral and borrows

Field	Description
`token_in`, `amount_in`	The token and amount taken from the Credit Account. If `token_in` differs from `collateral_token`, it’s swapped first. Leave both out, along with `collateral_token`, to borrow against collateral that’s already supplied.
`collateral_token`	The token to supply as collateral.
`borrow_token`, `borrow_amount`	What to borrow. The tokens land in the Credit Account.
`protocol`	`AAVE` (default), `MORPHO` with a `market_id`, or `EULER` with `collateral_vault` and `borrow_vault`.
`fee`	Optional. Your fee, taken from the borrowed amount. See Embedded Fees.
`gas_sponsorship`	Optional. `true` returns `eip_712` for the user to sign instead of a transaction. See Gas Sponsorship.

The user signs transaction and sends it. To pay the loan out to the user’s wallet, call transfer with action: "WITHDRAW". This works while the loan is open. See Withdraw Funds.

3. Track the loan

curl "https://api.compasslabs.ai/v2/credit/positions?chain=base&owner=0xYourWalletAddress" \
  -H "x-api-key: $COMPASS_API_KEY"

Field	What it tells you
`account_summary`	`health_factor`, `total_collateral_usd`, `total_debt_usd`, `ltv` and `available_borrows_usd`.
`collateral_positions`	Each collateral token with `amount_supplied`, `usd_value`, `supply_apy`, `interest_earned` and its event history.
`debt_positions`	Each borrowed token with `amount_borrowed`, `usd_value`, `borrow_apy`, `interest_paid` and its event history.
`borrowable_tokens`	How much more of each token the user can borrow right now, with its rate.

The health factor is the distance to liquidation. Above 1 is safe. Below 1, anyone can liquidate the position on-chain. Show it in your UI and alert users when it gets close to 1.

4. Repay

Repay 0.2 WETH and withdraw the 1,000 USDC collateral in one transaction:

response = httpx.post(
    "https://api.compasslabs.ai/v2/credit/repay",
    json={
        "owner": "0xYourWalletAddress",
        "chain": "base",
        "repay_token": "WETH",
        "repay_amount": "0.2",
        "withdraw_token": "USDC",
        "withdraw_amount": "1000",
    },
    headers={"x-api-key": "YOUR_API_KEY"},
)
result = response.json()

# result["transaction"]: unsigned tx that repays and withdraws the collateral

const response = await fetch("https://api.compasslabs.ai/v2/credit/repay", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "x-api-key": "YOUR_API_KEY",
  },
  body: JSON.stringify({
    owner: "0xYourWalletAddress",
    chain: "base",
    repay_token: "WETH",
    repay_amount: "0.2",
    withdraw_token: "USDC",
    withdraw_amount: "1000",
  }),
});
const result = await response.json();

// result.transaction: unsigned tx that repays and withdraws the collateral

The Credit Account must hold the repay_token. Interest accrues on the debt every block, so read amount_borrowed from debt_positions right before you build the repayment. Leave out withdraw_token and withdraw_amount to repay without withdrawing. Set token_out to have the withdrawn collateral swapped into another token. Afterwards, send the collateral to the user’s wallet with transfer. See Withdraw Funds.

Good to know

Morpho and Euler. Send protocol: "MORPHO" with the market_id, or protocol: "EULER" with collateral_vault and borrow_vault, on borrow and repay alike. On Morpho, collateral_token and borrow_token must be the market’s own pair. An identifier that doesn’t match the protocol, such as a market_id on Aave, returns 422.
On HyperEVM, AAVE and MORPHO select the chain’s equivalent lending venues. Nothing else changes.
Several Euler loans in one account. Euler allows one borrow market per account, so give each extra loan its own sub_account_id (1 to 255) and pass the same id when you repay. Positions report the id they live in.
Supply collateral without borrowing. Use bundle with a CREDIT_SUPPLY action. Bundles also combine supply, borrow, repay, withdraw, swap and transfer actions into one transaction.
Leverage. To multiply a position by supplying, borrowing and swapping in a loop, see Leveraged Looping.
Errors. Credit endpoints return 400 Credit Account not deployed until the account exists on that chain. Calling a protocol on a chain that doesn’t have it returns 422 with the chains that do.

Endpoints

Endpoint	Use it to
`GET /v2/earn/aave_markets`	Aave supply and borrow rates.
`GET /v2/credit/morpho_markets`	Curated Morpho markets with their `market_id`.
`GET /v2/credit/euler_markets`	Curated Euler markets with their vault addresses.
`POST /v2/credit/borrow`	Supply collateral and borrow.
`POST /v2/credit/repay`	Repay and withdraw collateral.
`GET /v2/credit/positions`	Collateral, debt, rates and health factor.
`GET /v2/credit/balances`	Idle token balances in the Credit Account.
`POST /v2/credit/swap`	Swap tokens inside the Credit Account.
`POST /v2/credit/bundle`	Several credit actions in one transaction.

Leveraged Looping

Open and unwind leveraged positions in one transaction.

Embedded Fees

Earn a fee on every loan.

Gas Sponsorship

Pay gas for your users so they never need ETH.

Get Started

Products

Data

Account Lifecycle

Platform Concepts

Developer Tools

Resources

Before you start

1. Pick a market

2. Borrow

3. Track the loan

4. Repay

Good to know

Endpoints

Next

Leveraged Looping

Embedded Fees

Gas Sponsorship

​Before you start

​1. Pick a market

​2. Borrow

​3. Track the loan

​4. Repay

​Good to know

​Endpoints

​Next

Leveraged Looping

Embedded Fees

Gas Sponsorship

Before you start

1. Pick a market

2. Borrow

3. Track the loan

4. Repay

Good to know

Endpoints

Next