Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.turtle.xyz/llms.txt

Use this file to discover all available pages before exploring further.

Share a link to a Turtle featured deal with your distributor ID attached. When someone deposits through your link, the deposit is attributed to you and counts toward your revenue share.
Share links only work with Turtle featured deals, the opportunities listed on app.turtle.xyz/earn/opportunities. Non-featured or external vault URLs will not trigger attribution.
https://app.turtle.xyz/earn/opportunities/{slug}?distId={your_distributor_id}
PartWhat it isWhere to find it
slugThe deal’s URL identifierCopy it from the URL bar when viewing the deal on app.turtle.xyz
distIdYour distributor IDIn the Distribution Dashboard

Example

The Lido stETH deal is a featured deal on Turtle. Its slug is lido-earneth. To share it with your distributor ID:
https://app.turtle.xyz/earn/opportunities/lido-earneth?distId=Y2Zi7KWy
The user lands on the Lido stETH deposit page. If they deposit, the deposit is attributed to Y2Zi7KWy.

How it works

  1. User clicks your link
  2. The app reads the distId parameter and embeds your distributor ID into the deposit transaction
  3. Turtle detects the deposit on-chain and attributes it to your account
No API integration or code needed. Attribution is automatic.

Verify a deposit

Confirm a deposit was attributed to you using the transaction hash:
curl -X GET "https://earn.turtle.xyz/v1/actions/verify?chainId=1&txHash=0xabc..." \
  -H "Authorization: Bearer pk_live_..."
See Verify Transaction for full details.

Sharing tips

Lead with the yield and the asset. Two lines plus the link is enough.
Earn stETH yield through Lido on Ethereum. One of the most battle-tested staking protocols in DeFi. https://app.turtle.xyz/earn/opportunities/lido-earneth?distId=Y2Zi7KWy

Track deposits

View attributed deposits in the Distribution Dashboard, or query them via the API:
curl -X GET "https://earn.turtle.xyz/v1/deposit/{your_distributor_id}?limit=50" \
  -H "Authorization: Bearer pk_live_..."
See Get Deposits for the full response format.

Using the Earn API instead

Share links are the no-code path. If you want to build a custom deposit flow in your own app, use the Earn API. The same attribution applies.

Distribution Dashboard

Track deposits and manage your integration.

Earn API Quickstart

Build a custom deposit flow with API access.