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

# Gearbox

> Deposit assets into Gearbox lending pools for passive yield

## What this yield is

* **Protocol**: Gearbox Protocol lending pools
* **Asset**: USDC, WBTC, WETH, USDT, GHO, DAI
* **Receipt token**: dTokens (e.g., dUSDCV3, dWETHV3)
* **Networks**: Ethereum, Arbitrum, Optimism

<Note>
  Gearbox Protocol combines lending and prime brokerage. Our integration allows users to deposit assets into lending pools and earn passive yield from borrower interest.
</Note>

## Required inputs

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

## Actions & lifecycle

<Tabs>
  <Tab title="Enter">
    **Action**: Deposit assets into Gearbox lending pool

    * Supply the underlying asset
    * Receive dToken representing your share
    * Yield accrues automatically via `pricePerShare`
  </Tab>

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

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

## Example flow

<Steps>
  <Step title="Get yield metadata">
    Fetch available Gearbox pools 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-dusdcv3-0xda00000035fef4082f78def6a8903bee419fbf8e-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-dusdcv3-0xda00000035fef4082f78def6a8903bee419fbf8e-4626-vault",
      "address": "0xYOUR_ADDRESS",
      "arguments": {
        "amount": "1000"
      }
    }'
  ```
</CodeGroup>

## Operational notes

<AccordionGroup>
  <Accordion title="No pending actions">
    Gearbox lending pools have no pending actions. All rewards accrue automatically.
  </Accordion>

  <Accordion title="ERC-4626 standard">
    Gearbox pools follow the ERC-4626 standard for seamless DeFi composability.
  </Accordion>

  <Accordion title="Passive yield">
    Users earn yield from interest paid by borrowers using Gearbox's leveraged strategies.
  </Accordion>
</AccordionGroup>

## Yield IDs for this protocol

<AccordionGroup>
  <Accordion title="Show Gearbox yield IDs">
    **Yield ID pattern**: `{network}-{asset}-d{asset}v3-{contract}-4626-vault`

    ### Ethereum

    | Yield ID                                                                    | Name                  |
    | --------------------------------------------------------------------------- | --------------------- |
    | ethereum-usdc-dusdcv3-0xda00000035fef4082f78def6a8903bee419fbf8e-4626-vault | USDC v3 Gearbox Vault |
    | ethereum-wbtc-dwbtcv3-0xda00010eda646913f273e10e7a5d1f659242757d-4626-vault | WBTC v3 Gearbox Vault |
    | ethereum-weth-dwethv3-0xda0002859b2d05f66a753d8241fcde8623f26f4f-4626-vault | WETH v3 Gearbox Vault |
    | ethereum-usdt-dusdtv3-0x05a811275fe9b4de503b3311f51edf6a856d936e-4626-vault | USDT v3 Gearbox Vault |
    | ethereum-gho-dghov3-0x4d56c9cba373ad39df69eb18f076b7348000ae09-4626-vault   | GHO v3 Gearbox Vault  |
    | ethereum-dai-ddaiv3-0xe7146f53dbcae9d6fa3555fe502648deb0b2f823-4626-vault   | DAI v3 Gearbox Vault  |

    ### Arbitrum

    | Yield ID                                                                      | Name                    |
    | ----------------------------------------------------------------------------- | ----------------------- |
    | arbitrum-usdc-dusdcv3-0x890a69ef363c9c7bdd5e36eb95ceb569f63acbf6-4626-vault   | USDC v3 Gearbox Vault   |
    | arbitrum-usdc.e-dusdcv3-0xa76c604145d7394dec36c49af494c144ff327861-4626-vault | USDC.e v3 Gearbox Vault |
    | arbitrum-weth-dwethv3-0x04419d3509f13054f60d253e0c79491d9e683399-4626-vault   | WETH v3 Gearbox Vault   |

    ### Optimism

    | Yield ID                                                                      | Name                    |
    | ----------------------------------------------------------------------------- | ----------------------- |
    | optimism-usdc.e-dusdcv3-0x5520daa93a187f4ec67344e6d2c4fc9b080b6a35-4626-vault | USDC.e v3 Gearbox Vault |
    | optimism-weth-dwethv3-0x42db77b3103c71059f4b997d6441cfb299fd0d94-4626-vault   | WETH v3 Gearbox Vault   |
  </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>