# User Statistics

> `GET /api/user/stats`: User endpoint of the Rone Arena API.

**Deprecated:** still answers, but will not receive further work. Prefer another endpoint.

**Sign-in required:** send `Authorization: Bearer <jwt>`. Get the JWT from `POST /api/user/auth/send-vc` then `POST /api/user/auth/login`.

Retrieve the authenticated player's overall statistics using a valid JWT. Supports query parameter for localization (`lang`). Requires an Authorization header with the JWT from login.

Headers:
- **Authorization**: `Bearer <jwt>` (JWT obtained during login).

Query parameters:
- **lang**: Language code for localized content (default: `en`).

The response includes general player statistics:
- **wc**: Win Count (total matches won).
- **tc**: Total Count (total matches played).
- **as**: Average Score (overall performance rating, as/100).
- **gt**: Game Time (total play time duration in hours).
- **mvpc**: MVP Count (number of times player earned MVP).
- **wsc**: Win Streak Count (longest consecutive wins).

Hero-specific highlights:
- **mo**: Most Often (hero most damage dealt).
- **hk**: Highest Kills (hero with the most kills).
- **ma**: Most Assists (hero contributing the most assists).
- **ms**: Most Score (hero with the highest accumulated score).
- **mdt**: Most Damage Taken (hero absorbing the most damage).
- **mg**: Most Gold (hero earning the most gold).
- **mtd**: Most Total Damage (hero dealing the most damage overall).

Each hero highlight includes metadata such as:
    - **v**: Value or statistic for the highlight. if `ms` is used, it calculates `v/100`.
    - **ts**: Timestamp of the highlight.
    - **hid**: Hero ID.
    - **n**: Hero name.
    - **ix**: Hero image URL.
    - **i2x**: Large hero image URL.
    - **bid**: Battle ID reference.

This endpoint is useful for:
- Analyzing overall player performance.
- Identifying favorite heroes.
- Showcasing personal achievements in Mobile Legends: Bang Bang.

## Request

`GET https://arena.rone.dev/api/user/stats`

### Parameters

| Name | In | Type | Required | Default | Description |
| --- | --- | --- | --- | --- | --- |
| `lang` | query | string | no | `en` | Language code for localized content. One of: `en`, `id`, `ru`, `es`, `pt`, `tr`, `ar`, `de`, `fr`, `it`, `ja`, `ko`, `th`, `vi`, `zh-CN`, `zh-TW`, `km`. |

### Example

```bash
curl -X GET 'https://arena.rone.dev/api/user/stats' \
  -H 'Authorization: Bearer <jwt>'
```

## Example response

```json
{
  "code": 0,
  "message": "Success",
  "traceID": "b506b47e790797eb1f9762d2f1586496",
  "data": {
    "wc": 188,
    "tc": 308,
    "as": 762.3552,
    "gt": 77.95,
    "mvpc": 73,
    "wsc": 11,
    "mo": {
      "v": 112848,
      "ts": 1726010389,
      "hid": 36,
      "bid": 4110381620662451700,
      "sid": 0,
      "hid_e": {
        "id": 36,
        "n": "Aurora",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fed2295c60bd772b89b7bdbbc2aee6095.png",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_58b97db6a5c286059057d42289612b16.jpg"
      },
      "bid_s": "4110381620662451526"
    },
    "hk": {
      "v": 25,
      "ts": 1672500616,
      "hid": 84,
      "bid": 4108435467847910000,
      "sid": 0,
      "hid_e": {
        "id": 84,
        "n": "Ling",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fcommunity%2F100_af4312bae7aa443129b46a17b4dce3a6.png",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_f76a7dfe805afa316e5ec44295b75772.jpg"
      },
      "bid_s": "4108435467847910024"
    },
    "ma": {
      "v": 31,
      "ts": 1725653347,
      "hid": 20,
      "bid": 4109721990994840000,
      "sid": 0,
      "hid_e": {
        "id": 20,
        "n": "Lolita",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fce1c7af1a946f70585e40296ba85c9c0.jpg",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_1bc4973e512cf4958fe639e12391666e.jpg"
      },
      "bid_s": "4109721990994840266"
    },
    "ms": {
      "v": 1330,
      "ts": 1715555863,
      "hid": 84,
      "bid": 4110821683001146000,
      "sid": 0,
      "hid_e": {
        "id": 84,
        "n": "Ling",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fcommunity%2F100_af4312bae7aa443129b46a17b4dce3a6.png",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_f76a7dfe805afa316e5ec44295b75772.jpg"
      },
      "bid_s": "4110821683001146109"
    },
    "mdt": {
      "v": 372063,
      "ts": 1727227888,
      "hid": 20,
      "bid": 4109978035471765500,
      "sid": 0,
      "hid_e": {
        "id": 20,
        "n": "Lolita",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fgms%2Fimage%2Fce1c7af1a946f70585e40296ba85c9c0.jpg",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_1bc4973e512cf4958fe639e12391666e.jpg"
      },
      "bid_s": "4109978035471765660"
    },
    "mg": {
      "v": 22282,
      "ts": 1718939040,
      "hid": 84,
      "bid": 4116060748536699000,
      "sid": 0,
      "hid_e": {
        "id": 84,
        "n": "Ling",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fcommunity%2F100_af4312bae7aa443129b46a17b4dce3a6.png",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_f76a7dfe805afa316e5ec44295b75772.jpg"
      },
      "bid_s": "4116060748536698631"
    },
    "mtd": {
      "v": 27152,
      "ts": 1719290587,
      "hid": 65,
      "bid": 4110233968270030300,
      "sid": 0,
      "hid_e": {
        "id": 65,
        "n": "Claude",
        "ix": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Fimg%2Fmlbb%2Fcommunity%2F100_7ed528f154dd4f460c59361ab0ed7942.png",
        "i2x": "https://wsrv.nl/?url=https%3A%2F%2Fakmweb.youngjoygame.com%2Fweb%2Fsvnres%2Ffile%2Fmlbb%2Fhomepage%2F100_1edf19b0839ffd2bffb60b4ee4953239.jpg"
      },
      "bid_s": "4110233968270030438"
    },
    "sids": [
      40,
      39,
      38,
      37
    ]
  }
}
```

## Links

- Try it in the playground: https://arena.rone.dev/web/user/stats
- User endpoints: https://arena.rone.dev/web/user.md
- OpenAPI schema: https://arena.rone.dev/api/openapi.json