# Get the statistics of a tournament

`GET https://api.cryptohopper.com/v1/tournaments/{tournament_id}/stats`

Part of [Tournaments](https://www.cryptohopper.com/api-documentation/api-reference/tournaments.md) in the Cryptohopper API reference.

Returns statistics of a published tournament: traded volume per quote currency, trade totals and the players with the most, first, last and most profitable trade. Each statistic has a readable label.

OAuth scope: `read`

Statistics are cached for about a minute. The player statistics are only present when the tournament has trades.

## Headers

| Name | Type | Required | Description |
|---|---|---|---|
| `access-token` | string | yes | The OAuth access token of the user. |

## Path parameters

| Name | Type | Required | Description |
|---|---|---|---|
| `tournament_id` | string | yes | Numeric ID of the tournament. |

## Example request

```bash
curl "https://api.cryptohopper.com/v1/tournaments/TOURNAMENT_ID/stats" \
  -H "access-token: YOUR_ACCESS_TOKEN"
```

## Response

Example response (illustrative values):

```json
{
    "data": {
        "labels": {
            "total_trades": "Total trades in tournament",
            "total_sells": "Total sells in tournament",
            "total_buys": "Total buys in tournament",
            "player_most_trades": "Player with most trades",
            "player_first_trade": "Player with the first trade",
            "player_last_trade": "Player with the last trade",
            "player_highest_trade": "Player with most profitable trade",
            "total_USDT": "Total volume in USDT"
        },
        "stats": {
            "total_USDT": "1,254,310.55 USDT",
            "total_trades": 1840,
            "total_sells": 902,
            "total_buys": 938,
            "player_most_trades": {
                "user_id": "123456",
                "stat": "212 trades",
                "player_name": "Trader Jane",
                "player_logo": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg",
                "player_id": "4567"
            },
            "player_first_trade": {
                "user_id": "234567",
                "player_name": "Hodl Henk",
                "player_logo": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg",
                "player_id": "5678"
            },
            "player_last_trade": {
                "user_id": "123456",
                "player_name": "Trader Jane",
                "player_logo": "https://cdn.example.com/images/social/uploads/avatar_4567.jpg",
                "player_id": "4567"
            }
        }
    }
}
```

Status codes: 200. Errors return JSON with `status`, `error` and `message`, plus a numeric `code` when the error comes from the API itself rather than the gateway.