> ## 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.

# Yearn

> Automated yield optimization through Yearn V3 vaults

## What this yield is

* **Protocol**: Yearn Finance V3 vaults
* **Asset**: USDC, USDT, DAI, WETH, and many more
* **Receipt token**: yvTokens (e.g., yvUSDC-A, yvDAI)
* **Networks**: Ethereum, Polygon, Arbitrum, Base, Katana

<Note>
  Yearn V3 vaults automatically optimize user deposits across various yield-generating strategies. The vault token accrues value over time and is redeemable for the underlying asset at any point.
</Note>

## Required inputs

| Parameter | Description                          |
| --------- | ------------------------------------ |
| `yieldId` | The specific Yearn V3 vault yield ID |
| `address` | User's wallet address                |
| `amount`  | Amount to deposit                    |

## Actions & lifecycle

<Tabs>
  <Tab title="Enter">
    **Action**: Deposit assets into Yearn vault

    * Supply the underlying asset
    * Receive yvToken representing your share
    * Vault automatically manages strategy allocation
  </Tab>

  <Tab title="Exit">
    **Action**: Withdraw assets from the vault

    * Redeem yvTokens for underlying assets
    * Receive principal plus accrued yield
    * Instant withdrawal
  </Tab>
</Tabs>

## Example flow

<Steps>
  <Step title="Get yield metadata">
    Fetch available Yearn vaults and their current rates.
  </Step>

  <Step title="Enter position">
    Call the enter action with your deposit amount.
  </Step>

  <Step title="Sign & submit">
    Sign the transaction and broadcast to the network.
  </Step>

  <Step title="Track balances">
    Monitor your position via the balances endpoint.
  </Step>
</Steps>

<CodeGroup>
  ```bash Get yield metadata theme={null}
  curl --request GET \
    --url 'https://api.yield.xyz/v1/yields/ethereum-yearn-v3-0xBe53A109B494E5c9f97b9Cd39Fe969BE68BF6204' \
    --header 'accept: application/json' \
    --header 'x-api-key: <API_KEY>'
  ```

  ```bash Enter position theme={null}
  curl --request POST \
    --url https://api.yield.xyz/v1/actions/enter \
    --header 'accept: application/json' \
    --header 'content-type: application/json' \
    --header 'x-api-key: <API_KEY>' \
    --data '{
      "yieldId": "ethereum-yearn-v3-0xBe53A109B494E5c9f97b9Cd39Fe969BE68BF6204",
      "address": "0xYOUR_ADDRESS",
      "arguments": {
        "amount": "1000"
      }
    }'
  ```
</CodeGroup>

## Operational notes

<AccordionGroup>
  <Accordion title="No pending actions">
    Yearn V3 vaults have no pending actions. Yield accrues automatically to the vault token.
  </Accordion>

  <Accordion title="Automated strategies">
    Vaults distribute deposits into strategy vaults to optimize returns across various yield sources including lending protocols, liquidity provision, and more.
  </Accordion>

  <Accordion title="Multi-network support">
    Yearn V3 is available on Ethereum, Polygon, Arbitrum, Base, and Katana networks.
  </Accordion>
</AccordionGroup>

## Yield IDs for this protocol

<AccordionGroup>
  <Accordion title="Show Yearn V3 yield IDs (partial list)">
    **Yield ID pattern**: `{network}-yearn-v3-{vault-address}`

    ### Ethereum (sample)

    | Yield ID                                                     | Name                |
    | ------------------------------------------------------------ | ------------------- |
    | ethereum-yearn-v3-0xBe53A109B494E5c9f97b9Cd39Fe969BE68BF6204 | USDC Yearn Vault V3 |
    | ethereum-yearn-v3-0x310B7Ea7475A0B449Cfd73bE81522F1B88eFAFaa | USDT Yearn Vault V3 |
    | ethereum-yearn-v3-0x028eC7330ff87667b6dfb0D94b954c820195336c | DAI Yearn Vault V3  |
    | ethereum-yearn-v3-0xc56413869c6CDf96496f2b1eF801fEDBdFA7dDB0 | WETH Yearn Vault V3 |
    | ethereum-yearn-v3-0x182863131F9a4630fF9E27830d945B1413e347E8 | USDS Yearn Vault V3 |

    ### Arbitrum (sample)

    | Yield ID                                                     | Name          |
    | ------------------------------------------------------------ | ------------- |
    | arbitrum-yearn-v3-0x6FAF8b7fFeE3306EfcFc2BA9Fec912b4d49834C1 | USDC-A yVault |
    | arbitrum-yearn-v3-0xc0ba9bfED28aB46Da48d2B69316A3838698EF3f5 | USDT-A yVault |

    ### Base (sample)

    | Yield ID                                                 | Name                 |
    | -------------------------------------------------------- | -------------------- |
    | base-yearn-v3-0xd5428B889621Eee8060fc105AA0AB0Fa2e344468 | Morpho Moonwell USDC |
    | base-yearn-v3-0xb13CF163d916917d9cD6E836905cA5f12a1dEF4B | True Yield Dollar    |

    *Full list contains 100+ yield IDs across networks.*
  </Accordion>
</AccordionGroup>

## See also

<CardGroup cols={2}>
  <Card title="Quickstart" icon="rocket" href="/documentation/getting-started/quickstart">
    Get started with Yield.xyz
  </Card>

  <Card title="Actions & Balances" icon="arrow-right-arrow-left" href="/documentation/core-concepts/actions-and-transactions">
    Understand how actions work
  </Card>
</CardGroup>