---
title: "Modify points category"
method: PATCH
path: "/admin/points"
tags: ["Admin"]
---

# Modify points category

`PATCH /admin/points`

## Request

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

Set a single point category's value for an existing wallet+epoch row (internal). Fails with NOT_FOUND if no ledger row exists yet — ingest must run first.

## Request body

- ApiModifyPointsCategoryRequest
  - `wallet_address` string
  - `points_epoch` string
  - `category` 'POINTS_CATEGORY_UNSPECIFIED' | 'POINTS_CATEGORY_TRADING' | 'POINTS_CATEGORY_REFERRAL' | 'POINTS_CATEGORY_TRADING_BOOSTED' | 'POINTS_CATEGORY_REFERRAL_BOOSTED' | 'POINTS_CATEGORY_PAIR_BOOSTED' | 'POINTS_CATEGORY_STREAKS_BOOSTED' | 'POINTS_CATEGORY_LIQUIDITY_PROVIDER': PointsCategory enumerates the 7 point categories from the points program spec.
  - `value` string

## Response `200`

A successful response.

- ApiModifyPointsCategoryResponse
  - `entry` 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.

## Changes

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

[Operation history](https://skmtc.dev/rise/apis/risex-rest-api/changes/admin/points/patch.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)