> For the complete documentation index, see [llms.txt](https://docs.api.epicbots.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.api.epicbots.xyz/coinsbot/users/transferer-un-solde.md).

# Transférer un solde

{% hint style="warning" %}
Le débit **ne s'effectue pas** si l'émetteur n'a pas assez de solde : l'opération est refusée (`400`) avant tout crédit du destinataire.
{% endhint %}

`GET` `/api/coinsbot/transfer/{type}`

***

### 🏷️ Types disponibles (`{type}`)

`coins` · `bank` · `entrepot` · `drugs` · `victoires`

***

### 🔧 Paramètres

| Paramètre    | Requis | Description                          |
| ------------ | :----: | ------------------------------------ |
| `GuildId`    |    ✅   | ID du serveur                        |
| `apiKey`     |    ✅   | Clé API du serveur                   |
| `fromUserId` |    ✅   | Émetteur (débité)                    |
| `toUserId`   |    ✅   | Destinataire (crédité)               |
| `amount`     |    ✅   | Montant (entier strictement positif) |

***

### 💡 Exemple

```http
GET /api/coinsbot/transfer/coins?GuildId=123&apiKey=CLE&fromUserId=111&toUserId=222&amount=500
```

***

### ✅ Réponse `200`

```json
{
  "GuildId": "123",
  "column": "Coins",
  "amount": 500,
  "from": "111",
  "to": "222",
  "toBalance": 1200
}
```

| Champ       | Description                                |
| ----------- | ------------------------------------------ |
| `toBalance` | Nouveau solde du destinataire après crédit |

***

### ❌ Erreurs

|  Code | Cause                                                                                     |
| :---: | ----------------------------------------------------------------------------------------- |
| `400` | Paramètre manquant/invalide, `amount` ≤ 0, émetteur = destinataire, **solde insuffisant** |
| `401` | Clé API invalide                                                                          |
| `500` | Erreur interne                                                                            |