---
title: "Get referral summary"
method: GET
path: "/v1/invite/referrals/summary/{account}"
tags: ["Invite"]
---

# Get referral summary

`GET /v1/invite/referrals/summary/{account}`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/v1/invite/referrals/summary/{account}`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/v1/invite/referrals/summary/:account/get.ts> (a function with typed inputs; its response is checked against the schema)

Get aggregate referral statistics: total referred volume, activated traders count, and code-status counts (active / redeemed / expired / expiring within 24h).

## Path parameters

- `account` string, required

## Response `200`

A successful response.

- ApiGetReferralSummaryResponse
  - `total_referred_volume` string: Lifetime sum across all invitees of (maker + taker) non-liquidation match volume. Human-readable decimal string, e.g. "1234567.89".
  - `activated_traders` integer: Count of invitees whose accounts.status = ACTIVE.
  - `active_codes` integer
  - `redeemed_codes` integer
  - `expired_codes` integer: DEPRECATED: redemptions no longer expire. Always 0; kept for FE back-compat and will be removed once the FE drops them.
  - `expiring_soon_codes` integer
  - `referred_volume_all_time_maker` string: Lifetime maker / taker split of invitees' non-liquidation match volume. Mirrors invitees_volume_all_time_maker/_taker on GetInviteAccountResponse, which are now deprecated and will be removed after FE migrates.
  - `referred_volume_all_time_taker` string

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/v1/invite/referrals/summary/:account/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)