Activate referral

Activates a new trader using a referral code after verifying the authenticated user token owns the requested authority. Creates the user, claims the referral atomically, triggers onboarding, and waits up to 15s for the trader PDA to appear in PhoenixState.

POST /v1/referral/activate

Activate referral

cURL

curl --request POST \
  --url https://perp-api.phoenix.trade/v1/referral/activate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "authority": "string",
  "referral_code": "string"
}
'

200

{
  "trader_pda": "<string>"
}

Authorizations

Authorization · string · header · required

Bearer access token issued by /v1/auth/* login endpoints.

Body

application/json

JSON request payload for v1.invite_referrals_waitlist.activate_referral_authority.

authority · string · required

referral_code · string · required

Response

200

application/json

Trader created

trader_pda · string · required