Redeem a referral code

POST 
/api/v1/referrals/claim

Binds the signing wallet to the code owner as its referrer and grants the code's trading concession. The binding is permanent, so the request is wallet-signed rather than session authenticated. A wallet that already has a referrer keeps it and receives the concession; the response reports referrerBound false.

Request

Responses

200

Claim result

409

Code already claimed by this wallet, inactive, or expired

default

Error response. Prefer the nested ApiErrorResponse via X-SC-Error-Format: envelope-v1; existing unnegotiated handler responses can retain a documented legacy flat shape through the compatibility period.

Response Headers

X-Request-Id

Stable request correlation id generated or echoed by the server.