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

# Turtle Earn

> Distribute Turtle vault opportunities to your audience and earn a revenue share on every deposit you bring in.

Turtle Earn is Turtle's distribution product. You put Turtle vault opportunities in front of your users, the deposits they make get attributed to you on-chain, and you earn a share of the revenue on the liquidity you route in. Attribution is automatic: every deposit carries your distributor ID, so you do not build tracking infrastructure or reconcile anything by hand.

If you have an audience that wants DeFi yield, a newsletter, a wallet, a mobile app, or a community, Turtle Earn lets you offer them vetted opportunities and get paid for the deposits without running the vaults yourself.

<Info>
  A **distributor** is the integration point that deposits are attributed to. Your **distributor ID** is the identifier that ties a deposit back to you. An **opportunity** is a vault or campaign a user can deposit into. See the [glossary](/resources/glossary).
</Info>

<Note>
  New to the model? The [Distributor Model](/sdk/concepts/distributor-model) concept page walks through how attribution, opportunity scoping, and revenue share work, with a short video walkthrough.
</Note>

## What you get

<CardGroup cols={2}>
  <Card title="For distributors" icon="rocket">
    Surface selected DeFi opportunities to your users through a no-code link or a full API integration. Every attributed deposit earns a revenue share, tracked automatically against your distributor ID. No vault operation, no manual reconciliation.
  </Card>

  <Card title="For your users" icon="users">
    Deposit into vetted opportunities through an experience you control, in your product or through your link. Users keep custody of their position and can withdraw on the vault's terms.
  </Card>
</CardGroup>

## How Turtle Earn works

<Steps>
  <Step title="You integrate">
    Set up an organization, get a distributor ID, and pick an integration path: no-code share links or the Earn API. See [Before you start](/products/earn/before-you-start).
  </Step>

  <Step title="You configure opportunities">
    Choose which opportunities from the Turtle catalog to put in front of your users, tailored to your audience. See [Configure opportunities](/products/earn/configure-opportunities).
  </Step>

  <Step title="Users deposit">
    Your users deposit through your link or your app. The deposit carries your distributor ID in its on-chain calldata.
  </Step>

  <Step title="Turtle attributes the deposit">
    Turtle detects the deposit on-chain and attributes it to your distributor automatically. No callback or reporting call is needed.
  </Step>

  <Step title="You earn revenue">
    You earn a revenue share on the liquidity you route into Turtle opportunities. Attributed volume and earnings show up in the Distribution Dashboard.
  </Step>
</Steps>

For the attribution mechanics and the full request/response detail, see the [Turtle Earn API overview](/sdk/earn/overview).

## Two ways to integrate

There are two integration paths. Pick by how much control you want over the deposit experience and how much you want to build.

| Path        | What you build                                                                              | Best for                                                                                 |
| ----------- | ------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------- |
| Share links | Nothing. You share a per-opportunity link with your distributor ID attached.                | KOLs, newsletters, content creators, and non-technical partners who want to start today. |
| Earn API    | A custom deposit flow in your own product, generating and submitting transactions yourself. | Wallets, apps, and platforms that want deposits to happen inside their own interface.    |

Share links work only with Turtle featured deals. The Earn API covers the full catalog. See [Configure opportunities](/products/earn/configure-opportunities) for how the two paths differ in what you can put in front of users.

## Revenue share

You earn a percentage of the revenue generated by the liquidity you route into Turtle opportunities. Rates are set per distributor as part of your agreement with Turtle. Attributed volume and estimated earnings are visible in the [Distribution Dashboard](/partner-products/distribution-dashboard).

## Supported chains

Earn opportunities span a broad set of chains, including Ethereum, Base, Arbitrum, Avalanche, BSC, Optimism, Polygon, Linea, and Scroll, with more added regularly.

## Get started

* [**Before you start**](/products/earn/before-you-start) - Org setup, your API key, your distributor ID, and choosing an integration path.
* [**Configure opportunities**](/products/earn/configure-opportunities) - Pick which opportunities to put in front of your users and keep them current.
* [**Share links**](/partner-products/share-links) - The no-code path: share a featured deal with attribution built in.
* [**Turtle Earn API**](/sdk/earn/overview) - Generate deposit and withdrawal transactions and build a custom flow.