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

# Euler

> Supply assets into Euler EVK vaults for yield

## What this yield is

* **Protocol**: Euler Finance (EVK - Euler Vault Kit)
* **Asset**: USDC, USDT, WETH, WBTC, and many more
* **Receipt token**: eTokens (e.g., eUSDC, eWETH)
* **Additional rewards**: rEUL, and vault-specific rewards
* **Networks**: Ethereum, Arbitrum, Base, BSC, Polygon, Unichain, Avalanche, Sonic, Plasma

<Note>
  EVK vaults are extended ERC-4626 vaults that function as passive lending pools. Users earn yield from lending to borrowers. Different vaults are operated by various curators with different strategies.
</Note>

## Required inputs

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

## Actions & lifecycle

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

    * Supply the underlying asset
    * Receive eToken representing your share
    * Yield accrues automatically
  </Tab>

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

    * Redeem eTokens for underlying assets
    * Receive principal plus accrued interest
    * Instant withdrawal
  </Tab>

  <Tab title="Pending actions">
    **CLAIM\_REWARDS**: Claim incentive rewards

    Claim rEUL or other incentive tokens using the `CLAIM_REWARDS` pending action.
  </Tab>
</Tabs>

## Example flow

<Steps>
  <Step title="Get yield metadata">
    Fetch available Euler 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-usdc-eusdc-2-0x797dd80692c3b2dadabce8e30c07fde5307d48a9-4626-vault' \
    --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-usdc-eusdc-2-0x797dd80692c3b2dadabce8e30c07fde5307d48a9-4626-vault",
      "address": "0xYOUR_ADDRESS",
      "arguments": {
        "amount": "1000"
      }
    }'
  ```
</CodeGroup>

## Operational notes

<AccordionGroup>
  <Accordion title="rEUL rewards">
    Reward EUL (rEUL) converts 1:1 to EUL over 6 months: 20% unlocks immediately, 80% vests linearly. Locked EUL is forfeited if not fully vested.
  </Accordion>

  <Accordion title="Curator-operated vaults">
    Different vaults are managed by curators like Gauntlet, MEV Capital, Re7 Labs, Steakhouse, etc., each with different strategies and risk profiles.
  </Accordion>

  <Accordion title="Additional reward programs">
    Some vaults have additional rewards via Royco, Merkl, or Turtle Club platforms.
  </Accordion>

  <Accordion title="Multi-network availability">
    Euler is available on 10+ networks with hundreds of vault options.
  </Accordion>
</AccordionGroup>

## Yield IDs for this protocol

<AccordionGroup>
  <Accordion title="Show Euler yield IDs (partial list)">
    **Yield ID pattern**: `{network}-{asset}-e{vault}-{address}-4626-vault`

    ### Ethereum (sample)

    | Yield ID                                                                    | Name             |
    | --------------------------------------------------------------------------- | ---------------- |
    | ethereum-usdc-eusdc-2-0x797dd80692c3b2dadabce8e30c07fde5307d48a9-4626-vault | Euler Prime USDC |
    | ethereum-weth-eweth-2-0xd8b27cf359b7d15710a5be299af6e7bf904984c2-4626-vault | Euler Prime WETH |
    | ethereum-usdt-eusdt-2-0x313603fa690301b0caeef8069c065862f9162162-4626-vault | Euler Prime USDT |

    ### Base (sample)

    | Yield ID                                                                | Name            |
    | ----------------------------------------------------------------------- | --------------- |
    | base-usdc-eusdc-1-0x0a1a3b5f2041f33522c4efc754a7d096f880ee16-4626-vault | Euler Base USDC |
    | base-weth-eweth-1-0x859160db5841e5cfb8d3f144c6b3381a85a4b410-4626-vault | Euler Base WETH |

    ### Arbitrum (sample)

    | Yield ID                                                                    | Name              |
    | --------------------------------------------------------------------------- | ----------------- |
    | arbitrum-usdc-eusdc-1-0x0a1ecc5fe8c9be3c809844fcbe615b46a869b899-4626-vault | EVK Vault eUSDC-1 |
    | arbitrum-weth-eweth-1-0x78e3e051d32157aacd550fbb78458762d8f7edff-4626-vault | EVK Vault eWETH-1 |

    *Full list contains 500+ 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>