> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gauntlet.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Cases

> Four use cases that cover a complete Gauntlet integration: discover vaults, deposit, show returns, and track attribution.

## Discover Top-Performing Vaults

**Why:** Your users need to see which vaults are worth depositing into before they commit capital. Discovery is the entry point to every earn integration.

**What:** Filter, compare, and rank Gauntlet vaults by APY, TVL, protocol, strategy, risk tier, and chain — all from a single API endpoint.

**How:** Authenticate with the Gauntlet API, call `GET /v1/vaults` with your product's filters, sort results by the metric that matters most, and use vault detail endpoints to power your UI.

<Card title="Discover Top-Performing Vaults" icon="database" href="/guides/developer/earn/displaying-data">
  Follow the full discovery flow with code examples for filtering, ranking, and rendering vault data.
</Card>

***

## Deposit Your First Dollar

**Why:** Getting a user into a vault is the core transaction in any earn product. The SDK makes this a single function call with partner-controlled signing.

**What:** The SDK prepares deposit and withdrawal transactions — including approvals when needed — and returns normalized transaction objects. You sign and submit in your own wallet, MPC, or custody stack.

**How:** Initialize the SDK with your RPC clients and `builderCode`, call `getDepositTx(...)`, then send the resulting steps through your signing infrastructure.

<Card title="Deposit Your First Dollar" icon="arrow-right-arrow-left" href="/guides/developer/earn/deposits-and-withdrawals">
  Follow the end-to-end SDK deposit flow, see how withdrawals work, and confirm results through the API.
</Card>

***

## Show User's Return

**Why:** Users who can see their balance growing are more likely to stay deposited and deposit more. Return visibility is the most important retention surface.

**What:** Current position value, ROI over time, per-vault breakdowns, and a recent transaction feed — all from the Gauntlet API.

**How:** Call the user positions and timeseries endpoints with a wallet address to render portfolio charts, vault-level returns, and activity history.

<Card title="Show User's Return" icon="chart-line" href="/guides/developer/earn/show-users-return">
  Follow the full return flow for positions, ROI charts, and recent activity.
</Card>

***

## Track Your Attribution

**Why:** You need to know how much volume your integration is driving for reporting, revenue reconciliation, and partner operations.

**What:** Attribution is built into the SDK deposit flow automatically. The API surfaces the resulting activity data — transactions, events, and trend lines — for monitoring and reporting.

**How:** Set your `builderCode` on `GauntletClient` (requested from Gauntlet — not self-serve) and attribution is embedded in every transaction automatically. Query the events and transactions endpoints to inspect attributed activity and trend it over time.

<Card title="Track Your Attribution" icon="magnifying-glass-chart" href="/guides/developer/earn/tracking-volume">
  See the full tracking flow for events, transactions, trend lines, and monitoring options.
</Card>

***

## Go Live

Once you've built all four use cases, validate the complete experience before launch.

<Card title="Go-Live Checklist" icon="clipboard-check" href="/integrate/go-live">
  Validate discovery, onboarding, returns, and tracking before rolling out to production users.
</Card>