Skip to main content
Returns the rank and points for a single wallet address within a point system.

​
GET /api/sdk/wallet

​
Request

GET https://api.rewards.so/wallet?pointSystemId=your-uuid&address=0xabc123...
Authorization: Bearer rw_your_api_key

​
Query parameters

ParameterTypeRequiredDescription
pointSystemIdstringYesUUID of the point system
addressstringYesWallet address to look up

​
Response 200

{
  "address": "0x3d73d19f3daf0cd6ea798c49939336b00adff988",
  "points": 2610,
  "events": 2,
  "rank": 1
}

​
Response fields

FieldTypeDescription
addressstringWallet address (normalized to lowercase)
pointsnumberTotal points accumulated
eventsnumberTotal number of point events
ranknumberCurrent rank on the leaderboard

​
Errors

StatusMessageCause
404Wallet not found in this point systemAddress has never received points or been registered

​
Code examples

const res = await fetch(
  `https://api.rewards.so/wallet?pointSystemId=${POINT_SYSTEM_ID}&address=${walletAddress}`,
  { headers: { Authorization: `Bearer ${API_KEY}` } }
);

if (res.status === 404) {
  console.log("Wallet not found — user has no points yet");
} else {
  const { rank, points } = await res.json();
  console.log(`Rank #${rank} with ${points} points`);
}