Skip to main content
This page walks you through putting funds into a vault and taking them back out, entirely from the Turtle app. No code. If you want to do the same thing from your own backend, the deposit endpoint covers it programmatically; there is a link at the bottom.

Before you start

You need three things in place before you deposit.

A connected wallet

Any self-custody wallet you control. Turtle never holds your funds; it builds each transaction and you sign it from your wallet.

A supported chain

Your funds and your wallet should be on a chain Turtle supports. The app shows each vault’s chain, and you can filter the catalog by chain. See the chain list on the Yield Opportunities overview.

Membership, if the vault requires it

Some flows require your wallet to be a registered Turtle member before a deposit goes through. The app prompts you to register if it is needed.

Deposit from the Turtle app

1

Open the app and connect your wallet

Go to app.turtle.xyz and connect the wallet you want to deposit from.
2

Find a vault

Browse the catalog and filter by chain, deposit token, APY, or TVL until you find a vault you want. Open it to see its details, including whether it carries an active liquidity campaign or Streams reward.
3

Choose your deposit token

Enter how much you want to deposit. If you hold the vault’s native token, deposit it directly. If you hold a different token, the app can convert it for you as part of the deposit (see Deposit with any token below).
The APY shown is the vault’s current rate. Any liquidity campaign or Streams rewards stack on top and are tracked separately. See Track your rewards.
4

Approve and confirm

Approve the token spend if your wallet prompts for it, then confirm the deposit. Your wallet signs; the funds move on-chain to the vault.
5

See your position

For an instant vault, your position is active right away. For an async vault, the deposit may still be pending; finish it from the app once it is ready (see When a deposit completes later).

Deposit with any token

You do not have to hold a vault’s native token to deposit into it. If you hold a different supported token, the app converts it for you in the same flow: you choose the token you have, and Turtle routes the swap before the deposit lands. You end up with a position in the vault, having spent the token you started with. This is the same capability the API calls swap mode. As an LP, all it means is one fewer step: deposit with what is in your wallet instead of swapping first yourself.
A conversion is subject to slippage, the small price movement between quote and execution. The app shows the expected result before you confirm.

When a deposit completes later

Some vaults (the async type, used by protocols like Mellow and Lagoon) do not settle a deposit in one transaction. The vault queues your request and processes it a little later. While it is pending, you have two choices:
  • Claim it once the vault has processed it, to finish the deposit and activate your position.
  • Cancel it if you change your mind before it settles, to get your funds back.
You do both from the app, from the pending deposit itself.

Withdraw

1

Open the position

Find the vault position you want to exit in your portfolio in the app.
2

Enter an amount and confirm

Choose how much to withdraw, then confirm. Your wallet signs the transaction.
3

Receive your funds

For an instant vault, funds return to your wallet in the same transaction. For an async vault, the withdrawal may be queued and settle a little later.

Prefer to integrate programmatically?

Deposit (API)

Generate deposit transactions, deposit with any token, broadcast, and confirm attribution from your own backend.

Async deposits (API)

Queue, claim, and cancel pending deposits on async vaults from your own backend.

Withdraw (API)

Generate withdraw transactions and handle async withdrawals from your own backend.

Next steps

Track your rewards

Where to see your accrued yield, points, liquidity campaign rewards, and Streams rewards.

Trust and Security

Audits, proof of solvency, diligence, and the self-custody model.