--- title: "Wallet points" method: GET path: "/v1/points/wallet/{address}" tags: ["Points"] --- # Wallet points `GET /v1/points/wallet/{address}` ## Request - Base URL: `https://api.hylo.so` - URL: `https://api.hylo.so/v1/points/wallet/{address}` - Auth: none declared - TypeScript: (a function with typed inputs; its response is checked against the schema) Season-1 points of one wallet through `foldedThrough` (rebuilt daily after the fold). `totalPoints` = `basePoints` × (1 + `code` + `snapshot` + `crown` + `genesis`) + `referral.points`. Referral fields are as of the last rebuild (see `referralsSyncedAt`). An unknown wallet reads as zeros (never 404). A wallet in a merged group serves the group's profile: totals, multipliers, snapshots, referral, rank, buckets and `season0` are the group's, and `group` lists its wallets. `rank` is null when the wallet is not ranked (it created no referral code, or is excluded; for a group: no member created a code, or a member is rank-excluded); `season0` is the frozen season-0 record, null without one. `live` adds this wallet's provisional accrual since `foldedThrough` up to `live.asOf` (the last complete hour), computed per request with the daily fold's math and the wallet's current multipliers (a group: every wallet's tail); rank, referral points and the leaderboard stay daily. `null` when it cannot be computed right now — fall back to the daily fields. ## Path parameters - `address` string, required ## Response `200` Cache-Control: public, max-age=300. - PointsWallet - `address` string, required - `season` integer, required - `foldedThrough` string, date, required - `referralsSyncedAt` string, date-time, required: Neon's now() at the last referral refresh or copy. Referral fields and rank are as of the last rebuild (daily) and reflect that refresh or copy. - `totalPoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `basePoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `multipliers` object, required: Fractions (0.05 = +5%). - `code` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `snapshot` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `crown` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `genesis` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `snapshots` object[], required: Private-beta snapshots held; the boosts sum to `multipliers.snapshot`. - `name` string, required - `boost` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `referral` object, required - `code` string, nullable, required: The wallet's own code (first created). - `usedCode` string, nullable, required: The code the wallet redeemed. - `count` integer, required - `points` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `rank` integer, nullable, required - `rankedWallets` integer, required - `buckets` PointsBuckets, required: App bucket (Vercel column minus `_points`) → points; buckets without points are absent. - `season0` object, nullable, required - `totalPoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `basePoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `globalRank` integer, nullable, required - `referralPoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `referralCount` integer, nullable, required - `buckets` PointsBuckets, required: App bucket (Vercel column minus `_points`) → points; buckets without points are absent. - `season0Wallets` integer, required - `live` PointsLive, required: Provisional: the daily fields plus this wallet's (a group: its served profile's) accrual since `foldedThrough`, up to `asOf`. - `asOf` string, date-time, required: The last complete UTC hour; each position's tail ends at or before it. - `basePoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `totalPoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `buckets` PointsBuckets, required: App bucket (Vercel column minus `_points`) → points; buckets without points are absent. - `group` object: Set when the wallet is in a merged group; totals are the group's. Absent otherwise. `pending` = the group changed since the last rebuild: the totals are the last rebuilt profile's (a wallet added since serves its own numbers). - `primary` string, required - `pending` boolean, required - `wallets` object[], required - `address` string, required - `primary` boolean, required - `basePoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `boostedPoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float. - `buckets` PointsBuckets, required: App bucket (Vercel column minus `_points`) → points; buckets without points are absent. - `live` PointsBuckets, required: App bucket (Vercel column minus `_points`) → points; buckets without points are absent. ## Other responses - `400`: Invalid parameter. - `500`: No points rebuild yet, or a database error. ## Changes - **2026-10-23** `52f9b3405591`: 1 info - added the optional property `group` to the response with the `200` status - **2026-10-09** `371e8f43284d`: 1 info - added the required property `live` to the response with the `200` status - **2026-10-07** `5416977fb682`: 1 info - endpoint added [Operation history](https://skmtc.dev/hylo/apis/hylo-public-api/changes/v1/points/wallet/:address/get.md) --- [API](https://skmtc.dev/hylo/apis/hylo-public-api.md) - [All operations](https://skmtc.dev/hylo/apis/hylo-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hylo/apis/hylo-public-api/revisions/bebee168feea?raw)