> 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/classement.md).

# Classement

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

`GET` `/api/coinsbot/users/top`

***

### 🔧 Paramètres

| Paramètre | Requis |  Défaut | Description                             |
| --------- | :----: | :-----: | --------------------------------------- |
| `GuildId` |    ✅   |    —    | ID du serveur                           |
| `apiKey`  |    ✅   |    —    | Clé API du serveur                      |
| `sortBy`  |    ❌   | `total` | Critère de classement — voir /users/all |
| `order`   |    ❌   |  `desc` | `desc` (défaut) ou `asc`                |
| `limit`   |    ❌   |   `10`  | Nombre de joueurs (max `100`)           |

***

### 💡 Exemple

**Top 5 par coins en banque :**

```http
GET /api/coinsbot/users/top?GuildId=123&apiKey=CLE&sortBy=bank&limit=5
```

***

### ✅ Réponse `200`

```json
{
  "GuildId": "123",
  "sortBy": "bank",
  "order": "desc",
  "count": 5,
  "top": [
    { "rank": 1, "UserId": "111", "Coins": 50, "Bank": 99000, "Total": 99050 },
    { "rank": 2, "UserId": "222", "Coins": 10, "Bank": 42000, "Total": 42010 }
  ]
}
```

***

### ❌ Erreurs

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