Skip to main content
This page covers the independent rewards surfaces exposed through the API: Extended points, Robinhood points, and Ondo points and rewards, each tied to the account on that venue, plus Kinetiq kPoints, tied to your Hyperliquid wallet. They are unrelated — earning in one has no effect on any other.
Prerequisites: an active VOOI API token, plus the relevant exchange connected for whichever surface you are reading. All endpoints below carry your vooi_… bearer token.

​
Extended points

Extended points are read-only through the API — you accrue them by trading and providing liquidity on Extended, and these endpoints report the result. GET /extended/points returns a summary: your total points, overall rank, and the league tier you sit in for each of three programs (trading, liquidity, and referral rewards). League tiers run KING (highest) > QUEEN > ROOK > KNIGHT > PAWN. GET /extended/points/earned returns the per-season, per-epoch breakdown — each season carries its epoch rewards with the points earned and the epoch’s start and end dates. See the API reference for the full field tables.

​
Referral code

Registering on Extended through Register on Extended automatically applies the VOOI referral code — no client action is needed. To apply a different code, POST /extended/use-referral-code takes { code } and returns { "status": "ok" }. It fails if a code is already applied to the account, so treat it as a one-shot override before any code is set. This is Extended’s own endpoint. On the other venues a referral code can only be bound at registration: pass referralCode to POST /user-exchange/{exchange}/register/prepare and it is applied to the new account. Supported on Aster, Hyperliquid, Lighter, Robinhood, Extended, and Ondo; omit it and the VOOI code is applied.

​
Robinhood points

GET /robinhood/points returns your Robinhood points summary: total points and total referral points across the whole program, the points and referral points earned during the last completed week, and your all-time leaderboard rank (null when the account is not ranked yet).

​
Ondo points and rewards

Ondo splits its program into points and paid-out rewards, on two endpoints:
  • GET /ondo/points — totalPoints plus the breakdown by source (tradingPoints, referralPoints, marketBoostPoints, alphaStratPoints, bonusPoints), your leaderboard rank (-1 when not yet ranked), the pseudonym Ondo assigned the account, and updatedUnix, the Unix time in seconds of the last leaderboard recomputation.
  • GET /ondo/rewards/total — totalRewards, the total USDC paid out to the account across every weekly payout, as a decimal string.
rank uses a different “not ranked yet” sentinel on each venue: Ondo returns -1, Robinhood returns null. Check for both rather than treating either as a real position.

​
Kinetiq kPoints

Kinetiq kPoints are a rewards program keyed to your Hyperliquid wallet — a rewards balance you opt into, not something you trade. Enabling requires a connected Hyperliquid wallet — see Register on Hyperliquid or Use your own keys.

​
Enable kPoints

POST /kinetiq/enable takes a signature — a personal_sign of the exact literal message kPoints account verification, produced by your Hyperliquid wallet. The recovered signer must match your connected Hyperliquid wallet, or the request is rejected. On success it returns the verified { address }.

​
Read kPoints

Once enabled, GET /kinetiq/points returns your current balance, rank, and tier, and GET /kinetiq/status reports whether kPoints are enabled and for which address. See the API reference for the full field tables.

​
Next steps

Register on Extended

Connect Extended and auto-apply the VOOI referral code

Register on Hyperliquid

Connect the Hyperliquid wallet that backs kPoints