> 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/utilitaire/statistiques-dun-serveur.md).

# Statistiques d'un serveur

{% hint style="info" %}
Résultat mis en cache **30 secondes**.
{% endhint %}

`GET` `/api/coinsbot/users/stats`

***

### 🔧 Paramètres

| Paramètre | Requis | Description        |
| --------- | :----: | ------------------ |
| `GuildId` |    ✅   | ID du serveur      |
| `apiKey`  |    ✅   | Clé API du serveur |

***

### 💡 Exemple

```http
GET /api/coinsbot/users/stats?GuildId=123&apiKey=CLE
```

***

### ✅ Réponse `200`

```json
{
  "GuildId": "123",
  "players": 128,
  "totalCoins": 1500000,
  "totalBank": 8200000,
  "totalWealth": 9700000,
  "avgWealth": 75781.25,
  "maxWealth": 990000
}
```

| Champ         | Description                      |
| ------------- | -------------------------------- |
| `players`     | Nombre de joueurs                |
| `totalCoins`  | Somme des coins en main          |
| `totalBank`   | Somme des coins en banque        |
| `totalWealth` | Richesse totale (main + banque)  |
| `avgWealth`   | Richesse moyenne par joueur      |
| `maxWealth`   | Richesse du joueur le plus riche |

***

### ❌ Erreurs

|  Code | Cause              |
| :---: | ------------------ |
| `400` | `GuildId` manquant |
| `401` | Clé API invalide   |
| `500` | Erreur interne     |