Vertex Docs
  • Getting Started
    • ๐Ÿ“‹Overview
    • ๐Ÿ“œTable of Contents
    • ๐Ÿš€Mission
    • โš”๏ธVertex Edge
      • 1๏ธโƒฃVertex on Arbitrum
      • 2๏ธโƒฃBlitz on Blast
        • Blitz Documentation
      • 3๏ธโƒฃVertex on Mantle
        • ๐ŸŽ†Trading Rewards
        • ๐Ÿ“ŠPerpetual & Spot Market Specifications
        • ๐Ÿ–ฅ๏ธOpen-Source Contracts
        • ๐Ÿ”ŒAPI
      • 4๏ธโƒฃVertex on Sei
        • ๐Ÿ’ฐTrading Rewards
        • ๐Ÿ“ŠPerpetual & Spot Market Specifications
        • ๐Ÿ–ฅ๏ธOn-Chain Contracts
        • ๐Ÿ”ŒAPI
      • 5๏ธโƒฃVertex on Base
        • ๐Ÿ’ฐTrading Rewards
        • ๐Ÿ“ŠPerpetual & Spot Market Specifications
        • ๐Ÿ’ปOnchain Contracts
        • ๐Ÿ”ŒAPI
        • โœ๏ธCreate a Coinbase Smart Wallet
      • 6๏ธโƒฃVertex on Sonic
        • ๐Ÿ’ฐTrading Rewards
        • ๐Ÿ“ŠPerpetual & Spot Market Specifications
        • โ›“๏ธOn-Chain Contracts
        • ๐Ÿ”ŒAPI
      • 7๏ธโƒฃVertex on Abstract
        • ๐Ÿ“ŠMarket Specifications
        • โ›“๏ธOn-Chain Contracts
        • ๐Ÿ”ŒAPI
      • 8๏ธโƒฃBro.Trade on Berachain
        • โ›“๏ธOn-Chain Contracts
        • ๐Ÿ”ŒAPI
      • 9๏ธโƒฃVertex on Avalanche
        • ๐Ÿ’ฐTrading Rewards
        • ๐Ÿ“ŠMarket Specifications
        • โ›“๏ธOn-Chain Contracts
        • ๐Ÿ”ŒAPI
  • Basics
    • ๐Ÿ“ฝ๏ธProducts
    • โšกTechnical Architecture
    • ๐ŸงตUniversal Cross Margin
    • โœ‚๏ธIsolated Margin
    • โ„น๏ธSubaccounts & Health
    • โฐLiquidations & Insurance Fund
    • ๐Ÿ’ตPnL Settlements
    • ๐Ÿ“ŠPricing (Oracles)
    • ๐Ÿ’ฐFees
    • ๐Ÿ“ˆFunding Rates
    • ๐Ÿ“…Market Specifications
    • โšกOne-Click Trading
    • ๐Ÿ”ซTrigger Orders
    • ๐Ÿ—‚๏ธGMCI 30 & MEME Indices
    • ๐Ÿ’ฐTrade & Earn
      • ๐ŸคMaker Program
      • ๐Ÿ”Cross-Chain VRTX Rewards
      • โ“Trading Rewards - FAQs
    • ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘Referral Program
    • โš’๏ธResources & Links
    • โ”FAQs
  • VRTX Token
    • ๐ŸŽ“VRTX Tokenomics
    • ๐Ÿ“ŠToken Supply Distribution
  • More
    • ๐ŸŒGlossary
    • ๐Ÿ”ฌContracts & Code Audits
    • ๐Ÿฆ‹Bug Bounties
    • ๐Ÿ’ฝData & Research
    • ๐ŸชŸMaintenance Windows
    • ๐ŸTerms of Use
    • โœ๏ธStatement of Risk
    • ๐ŸŒRestricted Territories
    • ๐Ÿ“ธBrand Assets
  • Tutorials
    • ๐ŸQuick Start
    • ๐Ÿ–ฑ๏ธOne-Click Trading
    • โš™๏ธTrading Basics
    • โ™พ๏ธPerpetuals
    • ๐Ÿ”ฎSpot
    • ๐Ÿง‘โ€๐Ÿคโ€๐Ÿง‘Multiple Accounts
    • ๐Ÿ”ซTP/SL & Stop-Market
    • ๐Ÿ’ฐWithdrawals
    • โšกFast Withdrawals
    • ๐ŸŒ‰Cross-Chain Deposits
    • ๐Ÿ”„Lend, Borrow & Repay
    • โค๏ธMargin Health
    • ๐Ÿ’งPools
    • ๐Ÿ’ซVRTX Staking
    • โ†”๏ธSwitching Chains
    • ๐Ÿช™Trading Rewards
    • โœ‚๏ธShortcuts
  • Developer Resources
    • API
      • ๐Ÿ”ŒEndpoints
      • Gateway
        • Executes
          • Place Order
          • Place Isolated Order
          • Cancel Orders
          • Cancel Product Orders
          • Cancel And Place
          • Withdraw Collateral
          • Transfer Quote
          • Liquidate Subaccount
          • Mint LP
          • Burn LP
          • Link Signer
        • Queries
          • Status
          • Contracts
          • Nonces
          • Order
          • Orders
          • Subaccount Info
          • Isolated Positions
          • Market Liquidity
          • Symbols
          • All Products
          • Edge All Products
          • Market Prices
          • Max Order Size
          • Max Withdrawable
          • Max LP Mintable
          • Fee Rates
          • Health Groups
          • Linked Signer
          • Insurance
          • Min Deposit Rates
        • Signing
          • Examples
          • Q&A
      • Subscriptions
        • Authentication
        • Streams
        • Events
        • Rate limits
      • Archive (indexer)
        • Orders
        • Matches
        • Events
        • Summary
        • Candlesticks
        • Edge Candlesticks
        • Funding Rate
        • Interest & funding payments
        • Oracle Price
        • Perp Prices
        • Product Snapshots
        • Market Snapshots
        • Edge Market Snapshots
        • Maker Statistics
        • Merkle Proofs
        • Rewards
        • Referral Code
        • Liquidation Feed
        • Linked Signer Rate Limit
        • Subaccounts
        • Signatures
        • USDC Price
      • Trigger
        • Executes
          • Place Order
          • Cancel Orders
          • Cancel Product Orders
        • Queries
          • List Trigger Orders
      • V2
        • Assets
        • Pairs
        • APR
        • Orderbook
        • Tickers
        • Contracts
        • Trades
        • VRTX Token
      • Rate limits
      • Errors
      • Symbols
      • Depositing
      • Withdrawing (on-chain)
      • Integrate via Smart Contracts
      • Definitions / Formulas
    • Vertex Typescript SDK
      • Getting Started
      • How To
        • Create a Vertex client
        • Useful Common Functions
        • Query Markets & Products
        • Deposit Funds
        • Withdraw Funds
        • Manage Orders
      • User Guide
        • Client
          • Market
            • Place Order
            • Cancel Orders
            • Cancel Product Orders
            • Mint LP
            • Burn LP
            • Get All Markets
            • Get Latest Market Price
            • Get Market Liquidity
            • Get Open Subaccount orders
            • Get Historical Orders
            • Get Max Order Size
            • Get Max Mint LP
            • Get Candlesticks
            • Get Funding Rate
            • Get Product Snapshots
          • Spot
            • Approve Allowance
            • Deposit
            • Withdraw
            • Get Max Withdrawable
            • Get Token Contract for Product
            • Get Token Wallet Balance
            • Get Token Allowance
          • Perp
            • Get prices
          • Subaccount
            • Link Signer
            • Get Subaccount Linked Signer with Rate limits
            • Get Subaccount Summary
            • Get Subaccount Fee Rates
            • Get Subaccount Token Rewards
        • Engine Client
          • Executes
          • Queries
        • Indexer Client
          • Base Queries
          • Paginated Queries
        • Websocket
          • Executes
          • Queries
          • Subscriptions
        • Utilities
          • Contracts
          • Utils
      • API Reference
    • Vertex Python SDK
    • Vertex Rust SDK
    • Contracts
    • API/SDK Terms of Use
Powered by GitBook
On this page
  • Introduction to Vertex Yield Markets
  • How to Earn Interest (Lending)
  • Borrowing Assets
  • How to Borrow
  • How to Repay
Export as PDF
  1. Tutorials

Lend, Borrow & Repay

Learn about Vertexโ€™s yield markets, how to earn interest, and how to borrow assets.

PreviousCross-Chain DepositsNextMargin Health

Last updated 4 months ago

Contents:

  • Introduction to Vertex Yield Markets

  • Earn Interest (Automatically)

  • Borrowing

  • Repay Borrows


Introduction to Vertex Yield Markets

Vertex users benefit from Vertexโ€™s integrated money markets.

The money market was designed to help facilitate the borrowing and lending of spot assets between traders, which is especially helpful when taking leveraged spot positions.

You do NOT need to trade to make use of Vertexโ€™s money markets. Instead, users can utilize them in the same way they would use other lending protocols such as Aave.

  • Borrow assets and withdraw them to use elsewhere.

  • Deposit assets and automatically earn interest.

All of this happens within your unified cross-margin account, meaning that you can borrow assets against your basket of open positions, pools, and deposits. You also automatically earn interest on the assets you deposit and use as margin.


How to Earn Interest (Lending)

Lending and earning interest is as simple as depositing an asset.

Earning interest happens automatically on Vertex. You do not need to perform any additional actions after depositing to earn interest.

Vertexโ€™s money market is integrated -- meaning that the assets you deposit to use as margin can also be borrowed by other traders.

Borrowing Assets

This tutorial will cover how to borrow and withdraw assets for use elsewhere -- similar to how one would use lending apps like Aave.

As a Vertex user, you can borrow against your accountโ€™s unified margin composed of deposits, positions, and pools. You will pay a borrow APR for borrowing the asset.

How to Borrow

Step 1. Deposit.

  • Before borrowing, you need to deposit assets as collateral / margin.

Step 2. Initiate Borrow.

  • Click on [Borrow] button on the asset you want to borrow in any Balances table.

Alternatively:

  • Click on any [Withdraw] button and turn on the โ€˜Enable Borrowsโ€™ toggle.

Step 3. Enter Borrow Details.

  • Select the asset you want to borrow.

  • Enter the amount.

  • Check the summary and account impact.

How to Repay

This tutorial will focus on Vertexโ€™s Repay feature. You can also repay borrows by trading the spot asset directly.

How to Repay:

  • On the Balances table, click the [Repay] button for the borrow you wish to repay.

  • A pop-up will open.

  • There are 2 options / methods to repay: convert or deposit (see details below).

  • Select your method and enter in the amount to repay.

  • Review the summary.

  • Click the [Repay] button.

Repay Convert:

This method allows you to swap (convert) one balance to pay off the borrow.

  • Repay asset (i.e., wETH) by convert quote (i.e., USDC).

  • Repay quote by converting any positive non-quote balance.

Please note that the convert feature uses the market price to estimates the total. If the trade happens at a better exchange rate, you will end up with a small positive balance in the asset you were borrowing.

You can view current deposit APRs on the of the Vertex app or on the Balances table in the Portfolio Page.

If you are interested in borrowing to trade spot, please refer to the section in the Spot Trading tutorial.

Refer to the or Tutorials.

Click [Borrow and Withdraw] and sign transaction if you donโ€™t have enabled.

Earn Page
Quickstart
Cross-Chain Deposit
1-Click Trading
๐Ÿ”„
Learn About Money Markets on Vertex
Margin Spot
Page cover image