---
title: "Get Account Referral"
method: GET
path: "/v1/account/referral"
---

# Get Account Referral

`GET /v1/account/referral`

Get the authenticated account's invite code, parent referral code, direct
referral count, and fee share rate.

## Response `200`

Account referral response.

- AccountReferral
  - `code` string, required — Referral or invite code
  - `parent` string — Referral or invite code
  - `children_count` integer, required — Number of directly referred child accounts
  - `active_children_count` integer, required — Number of directly referred child accounts that have traded at least once since their referral was applied
  - `children_volume` string, required — Total notional volume traded by directly referred child accounts since their referral was applied
  - `children_fees` string, required — Total fees paid by directly referred child accounts since their referral was applied
  - `referrals_left` integer, required — Number of additional referrals remaining for this account's invite code
  - `fee_share_rate` string, required — Referral fee share rate. Defaults to 0.2.

## Other responses

- `401` — Unauthorized — missing or invalid `POLYMARKET-PROXY` / `POLYMARKET-SECRET` credentials. `error` is `unauthorized`.
- `429` — Too Many Requests. `error` distinguishes the limit that was hit: `ip_rate_limited` (per-IP token bucket), `action_rate_limited` (per-account action rate), or `open_orders_limit` (resting open-order cap).
- `500` — Internal server error. `error` is `internal_error`.

---

[API](https://skmtc.net/polymarket/apis/polymarket-perps-http-api.md) · [All operations](https://skmtc.net/polymarket/apis/polymarket-perps-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/polymarket/polymarket-perps-http-api/revisions/76e4e47cf3aa/schema)