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

# Venus

> Lend assets into Venus Protocol's core pools on BNB Chain

## What this yield is

* **Protocol**: Venus Protocol lending markets
* **Asset**: USDC, USDT, BNB, BTC, ETH, and 20+ other tokens
* **Receipt token**: vTokens (e.g., vBTC, vUSDC)
* **Network**: BNB Chain (BSC)

<Note>
  Upon lending into Venus, users receive vTokens which accrue value via the `pricePerShare` parameter. These tokens are redeemable for the underlying asset at any time.
</Note>

## Required inputs

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

## Actions & lifecycle

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

    * Supply the underlying asset
    * Receive vToken representing your position
    * Yield accrues via `pricePerShare` increase
  </Tab>

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

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

  <Tab title="Pending actions">
    **CLAIM\_REWARDS**: Claim additional incentives

    If a core pool is incentivized with additional tokens beyond the base yield, users can claim them via the `CLAIM_REWARDS` pending action.
  </Tab>
</Tabs>

## Example flow

<Steps>
  <Step title="Get yield metadata">
    Fetch available Venus 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/binance-usdc-venus-lending \
    --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": "binance-usdc-venus-lending",
      "address": "0xYOUR_ADDRESS",
      "arguments": {
        "amount": "1000"
      }
    }'
  ```
</CodeGroup>

## Operational notes

<AccordionGroup>
  <Accordion title="Yield accrual">
    Base yield accrues directly to the vToken via `pricePerShare` parameter increase. No claiming required for base yield.
  </Accordion>

  <Accordion title="Additional incentives">
    Some pools may have additional token incentives that can be claimed using `CLAIM_REWARDS`.
  </Accordion>

  <Accordion title="Instant withdrawals">
    vTokens are redeemable for underlying assets at any time, subject to pool liquidity.
  </Accordion>
</AccordionGroup>

## Yield IDs for this protocol

<AccordionGroup>
  <Accordion title="Show Venus yield IDs">
    **Yield ID pattern**: `binance-{asset}-venus-lending`

    ### BSC Core Pools

    | Yield ID                    | Name                        |
    | --------------------------- | --------------------------- |
    | binance-usdc-venus-lending  | USDC Binance Venus Lending  |
    | binance-usdt-venus-lending  | USDT Binance Venus Lending  |
    | binance-bnb-venus-lending   | BNB Binance Venus Lending   |
    | binance-btcb-venus-lending  | BTCB Binance Venus Lending  |
    | binance-eth-venus-lending   | ETH Binance Venus Lending   |
    | binance-cake-venus-lending  | CAKE BSC Venus Lending      |
    | binance-xvx-venus-lending   | XVS BSC Venus Lending       |
    | binance-dot-venus-lending   | DOT Binance Venus Lending   |
    | binance-aave-venus-lending  | AAVE Binance Venus Lending  |
    | binance-uni-venus-lending   | UNI Binance Venus Lending   |
    | binance-dai-venus-lending   | DAI Binance Venus Lending   |
    | binance-link-venus-lending  | LINK Binance Venus Lending  |
    | binance-wbeth-venus-lending | wbETH Binance Venus Lending |
    | binance-sol-venus-lending   | SOL Binance Venus Lending   |
    | binance-fdusd-venus-lending | FDUSD Binance Venus Lending |
    | binance-trx-venus-lending   | TRX Binance Venus Lending   |
    | binance-doge-venus-lending  | DOGE Binance Venus Lending  |
    | binance-xrp-venus-lending   | XRP Binance Venus Lending   |
    | binance-ada-venus-lending   | ADA Binance Venus Lending   |
    | binance-matic-venus-lending | MATIC Binance Venus Lending |
  </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>