---
title: "Get points history (admin)"
method: GET
path: "/admin/points/wallet/{wallet_address}/history"
tags: ["Admin"]
---

# Get points history (admin)

`GET /admin/points/wallet/{wallet_address}/history`

## Request

- Base URL: `https://api.testnet.rise.trade`
- URL: `https://api.testnet.rise.trade/admin/points/wallet/{wallet_address}/history`
- Auth: none required
- TypeScript: <https://skmtc.dev/rise/apis/risex-rest-api/docs/admin/points/wallet/:wallet_address/history/get.ts> (a function with typed inputs; its response is checked against the schema)

Get any wallet's per-epoch point breakdown (internal, no ownership check).

## Path parameters

- `wallet_address` string, required

## Response `200`

A successful response.

- ApiAdminGetPointsHistoryResponse
  - `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
    - `rank` string, int64: Rank within this epoch specifically (among every wallet with points in it) — distinct from the wallet's all-time rank in GetWalletPointsResponse.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-11-03** `98eabcd6a6ad`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/points/wallet/:wallet_address/history/get.md)

---

[API](https://skmtc.dev/rise/apis/risex-rest-api.md) - [All operations](https://skmtc.dev/rise/apis/risex-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/rise/apis/risex-rest-api/revisions/98eabcd6a6ad?raw)