---
title: "Claim the full claimable reward balance (referral + clan leader)"
method: POST
path: "/v1/users/me/referrals/claim"
tags: ["user", "referrals"]
---

# Claim the full claimable reward balance (referral + clan leader)

`POST /v1/users/me/referrals/claim`

Creates a payout for the entire claimable balance — referral earnings plus clan leader earnings when the user owns a clan — paid as a single USDC transfer to the user’s primary wallet on Hyperliquid. The amount is computed server-side. At most one claim can be in flight at a time.

## Response `200`

Successful response

- ClaimReferralRewardsOutput
  - `payoutId` string, required
  - `amountCents` integer, required

## Other responses

- `401` — Authorization not provided
- `409` — A previous claim is still being processed
- `412` — Nothing to claim or no payout wallet
- `503` — Reward payouts are temporarily unavailable (hot wallet cannot cover the claim)

---

[API](https://skmtc.net/legend/apis/legend-api.md) · [All operations](https://skmtc.net/legend/apis/legend-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/legend/legend-api/versions/34b8f4885f8a/schema)