---
title: "Get points history"
method: GET
path: "/v1/points/{wallet_address}/history"
tags: ["Points"]
---

# Get points history

`GET /v1/points/{wallet_address}/history`

Get a wallet's per-epoch point breakdown, ordered chronologically by distribution time (distribution_at). Requires JWT; wallet_address must match the caller's own account.

## Path parameters

- `wallet_address` string, required

## Response `200`

A successful response.

- ApiGetPointsHistoryResponse
  - `entries` ApiPointsHistoryEntry[]
    - `epoch` ApiPointsEpochDto — PointsEpochDto is an epoch's schedule. ends_at/distribution_at are 0 when unset.
      - `epoch_id` string
      - `starts_at` string, int64 — 0 = unset. Deprioritized: distribution_at is what drives reveal/countdown, starts_at is purely descriptive (e.g. does not apply to a retroactive drop).
      - `ends_at` string, int64
      - `distribution_at` string, int64 — 0 = unset. Points ingested for this epoch are invisible on every public read until now >= distribution_at.
      - `description` string
      - `is_adhoc` boolean — An ad-hoc (one-off/retroactive) drop still schedules and reveals normally, but is excluded from GetCurrentEpoch's "next upcoming drop" selection so it never overrides the frontend's weekly countdown.
    - `ledger` ApiPointsLedgerEntry — PointsLedgerEntry is a wallet+epoch row. Point values are decimal-as-string (columns are NUMERIC, not integer — boost multipliers may be fractional).
      - `wallet_address` string
      - `points_epoch` string
      - `trading_points` string
      - `referral_points` string
      - `trading_boosted_points` string
      - `referral_boosted_points` string
      - `pair_boosted_points` string
      - `streaks_boosted_points` string
      - `liquidity_provider_points` string
      - `total_points` string

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/rise/apis/risex-rest-api.md) · [All operations](https://skmtc.net/rise/apis/risex-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rise/risex-rest-api/revisions/194af8339c0d/schema)