---
title: "Wallet points history"
method: GET
path: "/v1/points/wallet/{address}/history"
tags: ["Points"]
---

# Wallet points history

`GET /v1/points/wallet/{address}/history`

## Request

- Base URL: `https://api.hylo.so`
- URL: `https://api.hylo.so/v1/points/wallet/{address}/history`
- Auth: none declared
- TypeScript: <https://skmtc.dev/hylo/apis/hylo-public-api/docs/v1/points/wallet/:address/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Per-day base (pre-multiplier) points of one wallet (a merged group: summed over its members as of the last rebuild, with the group's `multiplier`), oldest first, zero-filled, ending at `foldedThrough` and clipped to the season's first day. Excludes the `exponent_carry` lump (Vercel's carried Exponent season, booked on one day) and the season-start tail (2025-12-05 13:02:36–24:00 UTC, counted in `basePoints` but in no day), so the days do not sum to `basePoints`; multiply by `multiplier` for boosted points. Read live: a refold between rebuilds can move a day before the totals follow.

## Path parameters

- `address` string, required

## Query parameters

- `days` integer

## Response `200`

Cache-Control: public, max-age=300.

- PointsHistory
  - `address` string, required
  - `foldedThrough` string, date, required
  - `multiplier` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.
  - `days` object[], required
    - `day` string, date, required
    - `basePoints` string, required: Exact decimal as a plain string (e.g. "12.75", "0.0000001"). Never a float.

## Other responses

- `400`: Invalid parameter.
- `500`: No points rebuild yet, or a database error.

## Changes

- **2026-10-07** `5416977fb682`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hylo/apis/hylo-public-api/changes/v1/points/wallet/:address/history/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/2a2fb3d7fee8?raw)