---
updatedAt: 2026-09-01T16:18:39.000Z
---

Fetch the complete documentation index at: https://developers.wabbit.gg/llms.txt. Use this file to discover all available pages before exploring further. Append .md to any documentation page URL to get its markdown version.

# Modify Currency

# Modify Currency

Add, remove, or set a user's wallet, bank, or crystals

## Fields

| Field             | Type                                                          | Required | Description                                                                                                                 |
| ----------------- | ------------------------------------------------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- |
| `target`          | enum: wallet \| bank \| crystals                              | yes      | Which balance to modify.                                                                                                    |
| `operation`       | enum: add \| subtract \| set \| addPercent \| subtractPercent | yes      | addPercent/subtractPercent compute floor(current \* amount / 100).                                                          |
| `amount`          | number (as string) or { path }                                | yes      | Capped at 1,000,000,000.                                                                                                    |
| `preventNegative` | boolean                                                       | no       | Defaults to true; floors the result at 0.                                                                                   |
| `targetUserId`    | string or { path }                                            | no       | Cross-user write target; only valid on six of the seven modify\_\* step types (all except modify\_status) plus read\_field. |

## Example

```json
{
  "id": "01H8XGJVBWX7Y5Z3K9M2N4P6Q1",
  "type": "modify_currency",
  "target": "wallet",
  "operation": "add",
  "amount": "50",
  "preventNegative": true
}
```