# Aave Documentation

> Technical documentation for Aave Protocol (Aave V3 and Aave V4), GHO stablecoin, and governance. For protocol integrators and frontend engineers.

Aave is a decentralized non-custodial liquidity protocol. This documentation covers AaveKit (React/TypeScript/GraphQL SDK), smart contract references, and integration guides.

## When to use these docs

Use this documentation to integrate Aave or act on it programmatically: reading market data and rates, building supply, borrow, repay, withdraw, and swap transactions, GHO and Savings GHO, staking (Umbrella), governance, and liquidations. Start with Aave 101 for concepts, the AaveKit getting-started guides for the SDKs, or the smart contract references for direct onchain integration. Every page is also available as Markdown: append .md to any page URL, or send Accept: text/markdown.

## Programmatic access

- [Aave V4 GraphQL API](https://api.v4.aave.com/graphql): public endpoint for Aave V4 market data, user positions, and transaction building. No API key required.
- [Aave V3 GraphQL API](https://api.v3.aave.com/graphql): public endpoint for Aave V3 markets across supported chains.
- [Aave MCP server](https://mcp.aave.com): remote Model Context Protocol server for AI agents. Read markets and positions, simulate actions, and prepare unsigned Aave transactions for the user's wallet to sign.
- [OpenAPI description](https://aave.com/openapi.json): the GraphQL-over-HTTP transport of the Aave V4 API, machine-readable. The APIs are permissionless: no keys and no sign-in of any kind.

## Full documentation

One Markdown file per section, for loading a whole section at once. Each covers one section only, so Aave V4 and Aave V3 never mix.

- [Aave V4](https://aave.com/docs/aave-v4/llms-full.txt): every Aave V4 page.
- [Aave V3](https://aave.com/docs/aave-v3/llms-full.txt): every Aave V3 page.
- [Vaults](https://aave.com/docs/vaults/llms-full.txt): every Vaults page.
- [Aave MCP](https://aave.com/docs/mcp/llms-full.txt): every Aave MCP page.

## Contact

- Help center: https://aave.com/help
- X: https://x.com/aave
- Discord: https://discord.com/invite/aave

- [Aave 101](https://aave.com/docs/aave-101.md): Aave is a _liquidity protocol_: a decentralized system of smart contracts for supplying and borrowing digital assets.

## Aave V4

- [Aave V4 Overview](https://aave.com/docs/aave-v4.md): Aave V4 uses a _Hub & Spoke model_ for liquidity management: the Liquidity Hub consolidates protocol-wide liquidity and accounting, while Spokes implement mo…
- [Aave V4 React Quickstart](https://aave.com/docs/aave-v4/getting-started/react.md): AaveKit React for Aave V4 is a collection of React hooks for building decentralized applications on top of Aave V4.
- [Aave V4 TypeScript Quickstart](https://aave.com/docs/aave-v4/getting-started/typescript.md): AaveKit TypeScript for Aave V4 provides a type-safe, low-level API client for interacting with Aave V4.
- [Aave V4 GraphQL Quickstart](https://aave.com/docs/aave-v4/getting-started/graphql.md): AaveKit API is a GraphQL interface to query liquidity data and user positions and to prepare transactions.
- [Aave V4 Solidity Quickstart](https://aave.com/docs/aave-v4/getting-started/solidity.md): The Aave smart contract interfaces provide methods for interacting with Aave V4.
- [Aave V4 Liquidity Model](https://aave.com/docs/aave-v4/liquidity.md): Aave V4 manages liquidity through Liquidity Hubs, Spokes, and Reserves.
- [Aave V4 Liquidity Hubs](https://aave.com/docs/aave-v4/liquidity/hubs.md): Liquidity Hubs hold the shared liquidity of Aave V4 and grant each Spoke a credit line for borrowing and a debit line for supplying.
- [Aave V4 Assets](https://aave.com/docs/aave-v4/liquidity/assets.md): Assets represent ERC-20 tokens that can be supplied or borrowed within Aave V4.
- [Aave V4 Spokes](https://aave.com/docs/aave-v4/liquidity/spokes.md): Spokes are the modules users interact with; each Spoke draws liquidity from one or more Liquidity Hubs.
- [Aave V4 Reserves](https://aave.com/docs/aave-v4/liquidity/reserves.md): Reserves define how a Hub Asset is supplied and borrowed within a specific Spoke.
- [Aave V4 Supported Chains](https://aave.com/docs/aave-v4/liquidity/chains.md): Chains are the blockchain networks where Aave V4 is deployed.
- [Aave V4 Incentive Programs](https://aave.com/docs/aave-v4/liquidity/incentives.md): Aave V4 reserves may offer additional incentives beyond base lending rates.
- [Aave V4 User Positions](https://aave.com/docs/aave-v4/positions.md): A User Position represents the complete financial state of a user within a specific Spoke, tracking User Supplies and User Borrows alongside key risk metrics…
- [Fetch Open Positions on Aave V4](https://aave.com/docs/aave-v4/positions/fetch.md): Each user position captures a user’s activity within a Spoke, simplifying health and performance tracking.
- [Supply Assets on Aave V4](https://aave.com/docs/aave-v4/positions/supply.md): Supplying assets to Aave V4 allows you to:
- [Borrow Assets on Aave V4](https://aave.com/docs/aave-v4/positions/borrow.md): Borrowing assets from Aave V4 allows you to:
- [Repay Loans on Aave V4](https://aave.com/docs/aave-v4/positions/repay.md): Repaying borrowed assets allows you to:
- [Withdraw Assets on Aave V4](https://aave.com/docs/aave-v4/positions/withdraw.md): Withdrawing assets from Aave V4 allows you to:
- [Aave V4 Position Conditions](https://aave.com/docs/aave-v4/positions/conditions.md): User positions track two risk conditions: Dynamic Risk Configuration and User Risk Premium.
- [Swap Supply Asset on Aave V4](https://aave.com/docs/aave-v4/positions/swaps/supply.md): Swapping supply assets combines withdraw, swap, and re-supply into one step.
- [Swap Borrow Asset on Aave V4](https://aave.com/docs/aave-v4/positions/swaps/borrow.md): Swapping borrow assets combines repay, swap, and re-borrow into one step.
- [Repay with Supply on Aave V4](https://aave.com/docs/aave-v4/positions/swaps/repay.md): Repay with supply combines withdraw, swap, and repay into one step.
- [Aave V4 Position Managers](https://aave.com/docs/aave-v4/positions/managers.md): Position managers are smart contracts users can authorize to manage their positions, enabling automated actions like supplying, withdrawing, borrowing, and r…
- [Aave V4 Liquidations](https://aave.com/docs/aave-v4/positions/liquidations.md): Liquidate unhealthy positions to earn liquidation bonuses and help maintain protocol stability.
- [Aave V4 User Balances](https://aave.com/docs/aave-v4/tools/balances.md): User balances show a user’s token holdings across chains, aggregated by token type with supply and borrow APY information.
- [Aave V4 User Activities](https://aave.com/docs/aave-v4/tools/activities.md): View detailed activity history covering supplies, borrows, repayments, withdrawals, liquidations, and swaps, with built-in pagination support.
- [Aave V4 Exchange Rates](https://aave.com/docs/aave-v4/tools/exchange-rate.md): Exchange rates in Aave are provided by [Oracles](../../ecosystem/oracle) using Chainlink price feeds.
- [Aave V4 Swap Features](https://aave.com/docs/aave-v4/tools/swaps.md): Alongside the [Position Swaps](../positions/swaps/supply) feature, AaveKit provides the following tools for swapping:
- [AaveKit React Hooks Reference](https://aave.com/docs/aave-v4/reference/react-hooks.md): Reference for all public AaveKit React hooks for Aave V4.
- [BigDecimal Reference](https://aave.com/docs/aave-v4/reference/big-decimal.md): AaveKit represents all decimal numbers using the `BigDecimal` type to ensure high-precision arithmetic for financial computations.

## Aave V3

- [Aave V3 Overview](https://aave.com/docs/aave-v3/overview.md): Aave V3 is a non-custodial liquidity protocol on Ethereum and other major networks.
- [Aave V3 React Quickstart](https://aave.com/docs/aave-v3/getting-started/react.md): AaveKit React is a collection of React hooks for building decentralized applications on top of the Aave Protocol.
- [Aave V3 TypeScript Quickstart](https://aave.com/docs/aave-v3/getting-started/typescript.md): AaveKit TypeScript provides a type-safe, low-level API client for interacting with Aave Protocol V3.
- [Aave V3 GraphQL Quickstart](https://aave.com/docs/aave-v3/getting-started/graphql.md): AaveKit API is a GraphQL API to query market data and user positions and to prepare transactions.
- [Aave V3 Liquidity Pool](https://aave.com/docs/aave-v3/concepts/liquidity-pool.md): A _liquidity pool_ is an Aave market instance that
- [Aave V3 Reserves](https://aave.com/docs/aave-v3/concepts/reserve.md): A _reserve_ is an instance of a token within an Aave [liquidity
- [Aave V3 Incentives](https://aave.com/docs/aave-v3/concepts/incentives.md): Incentives within the Aave Protocol encourage active participation from suppliers and borrowers, enhancing liquidity and the overall efficiency of the protocol.
- [Aave V3 Market Data](https://aave.com/docs/aave-v3/markets/data.md): Learn how to discover available markets and access detailed market information in Aave.
- [Aave V3 User Positions](https://aave.com/docs/aave-v3/markets/positions.md): Monitor user positions and account health across Aave markets.
- [Supply Assets on Aave V3](https://aave.com/docs/aave-v3/markets/supply.md): Supply assets to Aave V3 markets to earn interest, and enable or disable them as collateral.
- [Borrow Assets on Aave V3](https://aave.com/docs/aave-v3/markets/borrow.md): Borrow assets from Aave V3 markets against your collateral, or delegate your borrowing power.
- [Repay Loans on Aave V3](https://aave.com/docs/aave-v3/markets/repay.md): Repay borrowed assets to Aave V3 markets.
- [Withdraw Assets on Aave V3](https://aave.com/docs/aave-v3/markets/withdraw.md): Withdraw supplied assets from Aave V3 markets.
- [Aave V3 Health Factor Preview](https://aave.com/docs/aave-v3/markets/health-factor.md): Preview how a supply, borrow, repay or withdraw changes a user’s health factor before sending it.
- [Aave V3 Incentive Programs](https://aave.com/docs/aave-v3/markets/incentives.md): Aave reserves may offer additional incentives beyond base lending rates.
- [Aave V3 Advanced Market Features](https://aave.com/docs/aave-v3/markets/advanced.md): Implement advanced Aave features in DeFi applications.
- [Aave V3 Flash Loans](https://aave.com/docs/aave-v3/guides/flash-loans.md): Flash Loans let you borrow an asset without collateral, as long as the borrowed amount and a fee are returned before the end of the same transaction.
- [Aave V3 Credit Delegation](https://aave.com/docs/aave-v3/guides/credit-delegation.md): Credit delegation allows a supplier to contribute liquidity to the Aave protocol to earn interest, and delegate borrowing power (i.e.
- [Testing and Debugging Aave V3 Contracts](https://aave.com/docs/aave-v3/smart-contracts/testing-and-debugging.md): This guide covers testing and debugging Aave V3 integrations.
- [Aave V3 Smart Contracts](https://aave.com/docs/aave-v3/smart-contracts.md): The source code of the Aave V3 Protocol contracts is available on [GitHub](https://github.com/aave-dao/aave-v3-origin).
- [Aave V3 Pool Contract](https://aave.com/docs/aave-v3/smart-contracts/pool.md): This contract is the main user-facing contract.
- [Aave V3 L2 Pool Contract](https://aave.com/docs/aave-v3/smart-contracts/l2-pool.md): The main transaction cost on L2 comes from calldata.
- [Aave V3 Pool Configurator Contract](https://aave.com/docs/aave-v3/smart-contracts/pool-configurator.md): The `PoolConfigurator` contract implements the configuration methods for the Aave Protocol.
- [Aave V3 ACL Manager Contract](https://aave.com/docs/aave-v3/smart-contracts/acl-manager.md): The Access Control List Manager (`ACLManager`) is the main registry of system roles and permissions.
- [Aave V3 Pool Addresses Provider](https://aave.com/docs/aave-v3/smart-contracts/pool-addresses-provider.md): The `PoolAddressesProvider` contract is the main registry of addresses that are part of, or connected to the Protocol, including permissioned roles.
- [Aave V3 Tokenization Contracts](https://aave.com/docs/aave-v3/smart-contracts/tokenization.md): Reference for `AToken`, `RwaAToken`, `StataTokenFactory` and `VariableDebtToken`.
- [Aave V3 Oracle Contract](https://aave.com/docs/aave-v3/smart-contracts/oracles.md): The `AaveOracle` contract returns asset prices and manages price sources.
- [Aave V3 Interest Rate Strategy](https://aave.com/docs/aave-v3/smart-contracts/interest-rate-strategy.md): Implements the calculation of the interest rates depending on the reserve state.
- [Aave V3 Incentives Contracts](https://aave.com/docs/aave-v3/smart-contracts/incentives.md): The [`UiIncentiveDataProvider`](./view-contracts) provides methods to query all active incentive emissions, and claimable user incentives for a particular Aa…
- [Aave V3 Wrapped Token Gateway](https://aave.com/docs/aave-v3/smart-contracts/wrapped-token-gateway.md): The Aave Protocol operates exclusively with ERC-20 [reserve](../concepts/reserve) tokens.
- [Aave V3 Swap Contracts](https://aave.com/docs/aave-v3/smart-contracts/swap-features.md): The [Aave Labs interface](https://app.aave.com) offers several swap-based features, detailed below.
- [Aave V3 ATokenVault Contract](https://aave.com/docs/aave-v3/smart-contracts/vaults.md): The `ATokenVault` contract is an ERC-4626 compliant yield-bearing vault designed for Aave V3.
- [Aave V3 View Contracts](https://aave.com/docs/aave-v3/smart-contracts/view-contracts.md): The Aave Protocol has several view contracts to assist with querying onchain data.
- [Aave V3 on Aptos](https://aave.com/docs/aave-v3/aptos.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Smart Contracts on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Pool on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/pool.md): Aave V3 on Aptos is deprecated.
- [Aave V3 ACL Manager on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/acl-manager.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Pool Configurator on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/pool-configurator.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Oracles on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/oracles.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Tokenization on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/tokenization.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Logic Modules on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/aave-logic.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Incentives on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/incentives.md): Aave V3 on Aptos is deprecated.
- [Aave V3 Periphery on Aptos](https://aave.com/docs/aave-v3/aptos/smart-contracts/periphery.md): Aave V3 on Aptos is deprecated.
- [Aave Umbrella](https://aave.com/docs/aave-v3/umbrella.md): Aave Umbrella is a modular, onchain risk management system that automates bad debt coverage for Aave V3 pools.
- [Aave Horizon RWA Market](https://aave.com/docs/aave-v3/horizon.md): Aave Horizon is an Aave Labs initiative: a licensed, separate instance of the Aave Protocol, initially forked from V3.3, that creates a market for _Real-Worl…

## Vaults

- [Aave Stable Vaults](https://aave.com/docs/vaults/stable-vaults.md): Stable Vaults let financial platforms offer stable-rate earning on stablecoins without exposing their users to the complexity of DeFi.
- [Stable Vault Features](https://aave.com/docs/vaults/stable-vaults/features.md): Stable Vaults combine stable-rate earning, per-user rates, and access controls in one product.
- [Stable Vault Architecture](https://aave.com/docs/vaults/stable-vaults/architecture.md): The system is split across an Accounting Chain and one or more Earning Chains.
- [Stable Vault Yield Strategies](https://aave.com/docs/vaults/stable-vaults/yield-strategies.md): The Allocator routes assets into approved ERC-4626 strategies.
- [Aave Simple Earn Vaults](https://aave.com/docs/vaults/simple-earn/overview.md): Aave Simple Earn Vaults are ERC-4626 compliant yield-bearing vaults that allow users to supply and withdraw ERC-20 tokens supported by Aave V3.
- [Deploy an Aave Simple Earn Vault](https://aave.com/docs/vaults/simple-earn/deploy.md): To deploy a new Aave Simple Earn Vault, follow these steps:
- [Manage an Aave Simple Earn Vault](https://aave.com/docs/vaults/simple-earn/management.md): Manage your deployed vaults with fee configuration and revenue collection.
- [Aave Simple Earn Vault Data](https://aave.com/docs/vaults/simple-earn/data.md): Fetch a single vault, list vaults, and read a user’s vault positions, history, and activity.
- [Aave Simple Earn Vault Operations](https://aave.com/docs/vaults/simple-earn/operations.md): Execute core vault operations such as deposits and withdrawals.

## Aave MCP

- [Aave MCP](https://aave.com/docs/mcp.md): Aave MCP gives AI agents a single interface to Aave V3 and V4.
- [Get Started with Aave MCP](https://aave.com/docs/mcp/getting-started.md): Aave MCP is a remote server, so there is nothing to install and no key to manage.
- [Aave MCP Tools](https://aave.com/docs/mcp/tools.md): Aave MCP groups its tools into reads, action builders, orders (token swaps, position swaps and leverage), Savings GHO, DAO governance and guidance.
- [Aave MCP Skills](https://aave.com/docs/mcp/skills.md): A skill is a short procedure for one Aave flow, written for the model rather than for a person: which tools to call, in what order, and what a finished answe…
- [Aave MCP Safety](https://aave.com/docs/mcp/safety.md): Aave MCP reads live protocol data and builds transactions.

## Ecosystem

- [AAVE Token](https://aave.com/docs/ecosystem/aave.md): The AAVE token is the native governance token of the Aave Protocol.
- [GHO Stablecoin](https://aave.com/docs/ecosystem/gho.md): GHO (pronounced <i>go</i>) is a decentralized, over-collateralized stablecoin that is fully backed, transparent, and native to the Aave Protocol.
- [Savings GHO (sGHO)](https://aave.com/docs/ecosystem/gho/sgho.md): Savings GHO (sGHO) is a savings product for the GHO stablecoin, built as a native ERC-4626 vault and deployed on Ethereum mainnet.
- [Aave Governance](https://aave.com/docs/ecosystem/governance.md): The Aave Protocol is governed by the Aave DAO: AAVE, stkAAVE, and aAAVE holders on Ethereum Mainnet who propose, discuss, vote on, and execute protocol chang…
- [Aave Oracle](https://aave.com/docs/ecosystem/oracle.md): Each [reserve](/aave-v3/concepts/reserve) within the Aave Protocol is associated with an oracle contract.

## Optional

- [Aave Protocol Contract Addresses](https://aave.com/docs/reference/addresses.md)
- [Aave Protocol Parameters](https://aave.com/docs/reference/parameters.md)
- [Aave Protocol Access Controls](https://aave.com/docs/reference/access-controls.md): See the [Aave Permissions
- [Aave Glossary](https://aave.com/docs/resources/glossary.md)
- [Aave Protocol Risks](https://aave.com/docs/resources/risks.md): The Aave Protocol offers decentralized access to liquidity but is not without risks.
- [Aave Protocol Changelog](https://aave.com/docs/resources/changelog.md): Aave V4 launches on Base.
- [What Is Web3?](https://aave.com/docs/resources/web3.md): Web3 is the next evolution of the internet where people have control and ownership over their data, the relationships they form online, and their user profile.
- [Aave Code Licensing](https://aave.com/docs/resources/code-licensing.md): The Aave Protocol operates on decentralized blockchain networks, with smart contracts that are self-executing and publicly auditable.
- [Aave V1](https://aave.com/docs/resources/legacy-versions/v1.md): The following are key architectural differences between Aave V1 and subsequent protocol versions:
- [Aave V2](https://aave.com/docs/resources/legacy-versions/v2.md): The main entry point into the Aave Protocol.