> ## 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 in your product and earn revenue on every deposit.

Turtle Earn is a revenue-sharing product for partners who surface Turtle opportunities within their applications. Embed curated DeFi vault opportunities into your product — every deposit attributed to your integration earns you a share of the yield.

## How It Works

<Steps>
  <Step title="Sign Up">
    Create an organization in the [Client Portal](https://dashboard.turtle.xyz) and get approved as a distribution partner. You'll receive a unique `distributor_id` that scopes all activity to your integration.
  </Step>

  <Step title="Choose Your Integration">
    Pick the integration method that fits your product — from a no-code referral link to a full API integration. See options below.
  </Step>

  <Step title="Curate Opportunities">
    Select which vault opportunities to surface to your users via the Dashboard. Use the [Distributor Opportunities](/sdk/opportunities/distributor-opportunities) endpoint to fetch only your curated set.
  </Step>

  <Step title="Users Deposit">
    Your users discover and deposit into vaults through your integration. Turtle's attribution system automatically tracks every deposit back to your distributor ID.
  </Step>

  <Step title="Earn Revenue">
    You earn a percentage of yield generated by users you onboard. Revenue is tracked automatically in the Distribution Dashboard.
  </Step>
</Steps>

## Integration Options

Turtle Earn offers two integration paths depending on your technical needs.

### Referral Links (No Code)

The fastest way to start. Generate a link in the [Distribution Dashboard](https://dashboard.turtle.xyz) and share it with your audience. Users land on a hosted Turtle deposit page attributed to your distributor.

Best for: KOLs, newsletters, content creators, non-technical partners.

<Card title="Distribution Dashboard" icon="link" href="https://dashboard.turtle.xyz">
  Log in and generate your referral link in seconds.
</Card>

### Earn API (Full Integration)

Build a fully custom experience using the Earn API. Generate deposit and withdrawal transactions, query opportunities, and track user activity — all scoped to your distributor.

<CardGroup cols={2}>
  <Card title="Earn API Overview" icon="code" href="/sdk/earn-api/overview">
    Generate on-chain deposit and withdrawal transactions.
  </Card>

  <Card title="Opportunities API" icon="magnifying-glass" href="/sdk/opportunities/distributor-opportunities">
    Fetch your curated opportunity set by distributor ID.
  </Card>

  <Card title="Wallet Activity" icon="clock-rotate-left" href="/sdk/portfolio/activity">
    Query deposit and withdrawal history for any wallet.
  </Card>

  <Card title="Distributor Model" icon="sitemap" href="/sdk/earn-api/distributor-model">
    Understand how attribution and revenue tracking work.
  </Card>
</CardGroup>

## Attribution

Every deposit transaction generated through the Earn API embeds your `distributor_id` into the on-chain calldata. Turtle monitors all supported chains and automatically attributes deposits to your integration — no manual calls required.

See [Distributor Model](/sdk/earn-api/distributor-model) for the full attribution flow.

## Revenue Share

Distribution partners earn a percentage of yield generated by the liquidity they route into Turtle vaults. Revenue share rates are configured per-distributor in the Dashboard. Track your attributed volume and estimated earnings in the [Distribution Dashboard](https://dashboard.turtle.xyz).

## Supported Chains

Earn opportunities are available across 20+ chains including Ethereum, Base, Arbitrum, Avalanche, BSC, Optimism, Polygon, Linea, Scroll, and the Katana network — with more being added regularly.

## Getting Started

1. **Sign up** at [dashboard.turtle.xyz](https://dashboard.turtle.xyz)
2. **Get approved** — the Turtle team reviews new organizations
3. **Choose your integration** — referral link or API
4. **Start distributing** — share opportunities and earn revenue

<CardGroup cols={2}>
  <Card title="API Quickstart" icon="rocket" href="/sdk/quickstart">
    Go from zero to your first attributed deposit in five steps.
  </Card>

  <Card title="Earn API Docs" icon="book" href="/sdk/earn-api/overview">
    Full API documentation for deposits, withdrawals, and attribution.
  </Card>
</CardGroup>