> ## Documentation Index
> Fetch the complete documentation index at: https://yieldxyz.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Aave

> Supply reserve assets to Aave V3 pools and hold the aToken that represents your position.

Aave V3 is a pooled money market: you supply an asset to a network's reserve and earn the variable interest paid by borrowers of that reserve. yield.xyz exposes one lending yield per reserve, and entering mints the reserve's aToken directly to your address.

## Availability

| Network | Input tokens | Position token |
| - | - | - |
| Ethereum | Any listed reserve asset | aToken |
| Arbitrum | Any listed reserve asset | aToken |
| Base | Any listed reserve asset | aToken |
| Optimism | Any listed reserve asset | aToken |
| Polygon | Any listed reserve asset | aToken |
| BNB Chain | Any listed reserve asset | aToken |
| Avalanche C-Chain | Any listed reserve asset | aToken |
| Gnosis | Any listed reserve asset | aToken |
| Linea | Any listed reserve asset | aToken |
| Sonic | Any listed reserve asset | aToken |
| Plasma | Any listed reserve asset | aToken |
| Monad | Any listed reserve asset | aToken |

Yield IDs follow `{network}-{token}-aave-v3-lending`, for example `polygon-usdc-aave-v3-lending`. Query [`GET /v1/yields?providers=aave&types=lending`](/api-reference/YieldsController_getYields) for the reserves enabled for your project; the set of listed reserves differs by network.

## Entering

Enter takes a required `amount` and an optional `receiverAddress` to mint the aToken to a different address than the sender. yield.xyz builds an approval transaction (skipped if allowance already covers the amount) followed by the supply transaction. Aave issues the aToken in the same transaction, so interest starts accruing immediately.

yield.xyz blocks entering when Aave has frozen the reserve, or when the reserve's current supply rate is zero; exit stays available in both cases. Some reserves also enforce a per-reserve supply cap on Aave's side; once a reserve is at its cap, new supplies revert on-chain.

## Exiting

Exit takes an optional `amount`, a `useMaxAmount` flag to redeem the full aToken balance, and an optional `receiverAddress`. Aave burns the aToken and returns the underlying asset in the same transaction. There is no cooldown or unbonding step.

## Rewards and position

The aToken is pegged 1:1 to the underlying asset (`pricePerShare` is always `1`); interest accrues by increasing your aToken balance over time rather than by changing its price. The public `rewardRate` on the yield reflects Aave's live variable supply rate, computed from the reserve's on-chain utilization, not a fixed or historical figure.

Reward claiming is automatic: there is no separate claim step or pending action for interest. A small number of reserves also carry a secondary reward token that accrues alongside interest; check the yield's `rewardRate.components[].token` rather than assuming a single-token payout.

## List the live yields

Copy this request to list the Aave yields enabled for your project. Yield IDs change as markets and networks are added, so query the API rather than hardcoding them.

```bash theme={null}
curl "https://api.yield.xyz/v1/yields?providers=aave&limit=100" \
  -H "x-api-key: $YIELD_API_KEY"
```

## Next steps

<Columns cols={2}>
  <Card title="Lending" icon="hand-holding-dollar" href="/documentation/earn/defi/lending/index">
    Compare all supported lending protocols.
  </Card>

  <Card title="Action lifecycle" icon="arrows-rotate" href="/documentation/earn/core-concepts/actions">
    How enter and exit actions progress from creation to settlement.
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.