Referral

Caller's referral overview — `referralCode`, total-users-referred count, lifetime borrow + swap rewards earned, and claimable swap rewards. No mid-week accrual is exposed (stat-hiding invariant). FE composes the share link itself (its own URL + `?ref=<referralCode>`).

get

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200Success

No content

get/api/referral/me

HTTPcURLJavaScriptPython

GET /api/referral/me HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200Success

No content

Build an unsigned PSBT to claim bUSD rewards

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

payFeeAddressstringRequired

Referrer's 2-of-2 trading wallet address. Funds the claim tx (fee + dust) AND receives the claimed bUSD. Must be the calling referrer's own tradingAddress — the BE validates this against walletService before building.

Example: tb1pegd26fnpkgd95s432c8mmnnxa890xadnhq5ctgk48ruh979c9k4sf6mr3y

Responses

201Success

No content

post/api/referral/claim/build

HTTPcURLJavaScriptPython

POST /api/referral/claim/build HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "payFeeAddress": "tb1pegd26fnpkgd95s432c8mmnnxa890xadnhq5ctgk48ruh979c9k4sf6mr3y"
}

201Success

No content

Submit a signed referral bUSD-claim PSBT for broadcast

post

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

signedBase64TxstringRequired

Base64-encoded PSBT signed by the referrer

Responses

201Success

No content

post/api/referral/claim/sign

HTTPcURLJavaScriptPython

POST /api/referral/claim/sign HTTP/1.1
Host: api.radfi.co
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 25

{
  "signedBase64Tx": "text"
}

201Success

No content

Get an account's referrer (public)

get

Path parameters

accountIdstringRequired

Responses

200Success

No content

get/api/referral/users/{accountId}/referrer

HTTPcURLJavaScriptPython

GET /api/referral/users/{accountId}/referrer HTTP/1.1
Host: api.radfi.co
Accept: */*

200Success

No content