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

# Show User's Return

> Show a user's gtUSDa position, ROI over time, and recent activity using the SDK or API.

After a user deposits into gtUSDa, show them what they're earning.

## Load Current Position

<CodeGroup>
  ```typescript SDK theme={null}
  import { getUserCurrentBalance } from '@gauntlet-xyz/sdk'
  import { VaultId } from '@gauntlet-xyz/sdk/evm'

  const balances = await getUserCurrentBalance(client, {
    vaultId: VaultId.AeraUsdAlpha,
    address: '0xUser',
  })

  console.log(balances)
  // [
  //   {
  //     chain: 'base',
  //     token: '0xUSDCADDRESS123',
  //     decimals: 6,
  //     pendingDeposit: 0n,
  //     balance: 1_000_000n,
  //     pendingWithdraw: 0n,
  //   },
  // ]
  ```

  ```typescript API theme={null}
  // API vault IDs use chain_id:address (gtUSDa on Base shown here).
  const GTUSDA_BASE = '8453:0x000000000001cdb57e58fa75fe420a0f4d6640d5'

  const { data: positions, meta } = await apiGet(
    '/v1/users/0xUserWallet/positions/latest'
  )
  // meta.summary returns:
  // {
  //   total_value_usd: "12500.00",
  //   portfolio_apy: "7.8"
  // }

  const gtusda = positions.find(p => p.vault_id === GTUSDA_BASE)
  // returns:
  // {
  //   vault_id: "8453:0x000000000001cdb57e58fa75fe420a0f4d6640d5",
  //   shares: "968000000000000000000",
  //   asset_value: "1032.00",
  //   roi_pct: "3.2"
  // }
  ```
</CodeGroup>

## Chart Return Over Time

```typescript API theme={null}
const { data: portfolioCurve } = await apiGet(
  '/v1/users/0xUserWallet/positions/timeseries?granularity=day&start=2026-01-01'
)
// returns:
// [
//   { timestamp: "2026-01-01", value_usd: "10000.00", roi_usd: "0" },
//   { timestamp: "2026-02-01", value_usd: "10800.00", roi_usd: "800.00" },
//   ...
// ]

const { data: vaultCurve } = await apiGet(
  `/v1/users/0xUserWallet/positions/${GTUSDA_BASE}/timeseries?granularity=day&start=2026-01-01`
)
// returns:
// [
//   { timestamp: "2026-01-01", value_usd: "1000.00", roi_usd: "0" },
//   { timestamp: "2026-03-20", value_usd: "1032.00", roi_usd: "32.00" }
// ]
```

## Show Recent Activity

```typescript API theme={null}
const { data: txns } = await apiGet(
  `/v1/users/0xUserWallet/positions/${GTUSDA_BASE}/transactions?limit=20`
)
// returns:
// [
//   {
//     type: "deposit",
//     vault_id: "8453:0x000000000001cdb57e58fa75fe420a0f4d6640d5",
//     amount: "1000.00",
//     timestamp: "2026-01-15T10:30:00Z"
//   },
//   ...
// ]
```

## What's Next

<CardGroup cols={2}>
  <Card title="Track Your Attribution" icon="magnifying-glass-chart" href="/guides/developer/earn/tracking-volume">
    Monitor deposit volume and partner attribution across your integration.
  </Card>

  <Card title="User API Reference" icon="user" href="/api-reference/users/get-user-position-in-a-specific-vault">
    Full user positions, timeseries, and transactions endpoints.
  </Card>
</CardGroup>