> For the complete documentation index, see [llms.txt](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://scorpioplay.gitbook.io/scorpio-play-casino-api-doc/api-reference/openapi/v1-operator-transfer-balance.md).

# /v1/operator/transfer-balance

## Transfer balance to child operators

<mark style="color:$success;">`POST`</mark> `/v1/operator/transfer-balance`

Enables an authenticated operator to transfer balance to its child operators. The operator must have sufficient balance to complete the transfer.

**Headers**

| Name          | Value                |
| ------------- | -------------------- |
| Authorization | `Bearer <API_TOKEN>` |
| Content-Type  | `application/json`   |
| Accept        | `application/json`   |

**Body**

```json
{
  "targetOperatorId": "sub_operator_11",
  "currency": "USD",
  "amount": 100,
  "remark": "Transfer for monthly budget"
}
```

<table><thead><tr><th width="160">Field</th><th width="120">Data Type</th><th width="360">Description</th><th>Mandatory</th></tr></thead><tbody><tr><td>targetOperatorId</td><td>string</td><td>Unique identifier of the target (child or sub) operator receiving the transfer</td><td>Required</td></tr><tr><td>currency</td><td>string</td><td>Currency code of the transfer amount (e.g., USD)</td><td>Required</td></tr><tr><td>amount</td><td>number</td><td>Amount to be transferred to the target operator</td><td>Required</td></tr><tr><td>remark</td><td>string</td><td>Optional note or description for the transfer (e.g., purpose or reference)</td><td>Optional</td></tr></tbody></table>

**Response**

```json
{
  "success": true,
  "message": "OK",
  "data": {
    "currency": "USD",
    "myPreBalance": 100,
    "myAfterBalance": 0,
    "targetPreBalance": 0,
    "targetAfterBalance": 100
  }
```

<table><thead><tr><th width="218">Field</th><th width="116">Data Type</th><th>Description</th></tr></thead><tbody><tr><td>success</td><td>boolean</td><td>Indicates whether the transfer operation was successful</td></tr><tr><td>message</td><td>string</td><td>Response message describing the result (e.g., <code>OK</code>)</td></tr><tr><td>data.currency</td><td>string</td><td>Currency used for the transfer</td></tr><tr><td>data.myPreBalance</td><td>number</td><td>Sender operator’s balance before the transfer</td></tr><tr><td>data.myAfterBalance</td><td>number</td><td>Sender operator’s balance after the transfer</td></tr><tr><td>data.targetPreBalance</td><td>number</td><td>Target operator’s balance before the transfer</td></tr><tr><td>data.targetAfterBalance</td><td>number</td><td>Target operator’s balance after the transfer</td></tr></tbody></table>