Referral Status

Both sides of the current user's referral state: as a referrer (own code, referees) and as a referee (bound code).

GET /referral/status

Auth: Authorization: Bearer <JWT> from the EIP-712 login. API keys are not accepted.

Response

{
  "as_referrer": {
    "has_code": true,
    "code": "4DDDC2D4",
    "code_created_at": 1772010604000,
    "total_referrals": 3,
    "referees": [
      { "address": "0xabc...", "bound_at": 1770000000000 }
    ]
  },
  "as_referee": {
    "is_bound": false,
    "referrer_address": null,
    "referrer_code": null,
    "bound_at": null
  }
}

Field	Type	Description
`as_referrer.has_code`	bool	Whether a code exists
`as_referrer.code`	string \| null	8-char uppercase hex code
`as_referrer.code_created_at`	int64 \| null	ms
`as_referrer.total_referrals`	int	Referees currently bound
`as_referrer.referees`	array	Most recent 50 referees
`as_referee.is_bound`	bool	Bound to someone's code
`as_referee.referrer_address` / `referrer_code`	string \| null
`as_referee.bound_at`	int64 \| null	ms

Response​

Response