---
title: "Add test balance"
method: POST
path: "/balance"
---

# Add test balance

`POST /balance`

Add currency to balance. It's limited to 1 addition per day.

## Request body

- Balance
  - `token` string, required — hCaptcha token
  - `payload` object, required — Balance payload
    - `address` string — Public wallet address
    - `genesis` string — Genesis block hash

## Response `200`

Currency added successfully

## Other responses

- `400` — Bad request, missing or invalid parameters
- `403` — Forbidden, transfer limit reached or invalid address
- `500` — A server internal error

## Changes

- **2025-01-20** `12a1d58831ef` — 1 info
  - added the media type `application/json` for the response with the status `200`

[Change history](https://skmtc.dev/gear-tech/apis/api-documentation/changes/balance/post.md)

---

[API](https://skmtc.dev/gear-tech/apis/api-documentation.md) · [All operations](https://skmtc.dev/gear-tech/apis/api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gear-tech/api-documentation/revisions/12a1d58831ef/schema)
