# Game List

This is an API endpoint for retrieving a list of games associated with a specific provider.

### Endpoint

```
POST https://api.nexusggr.com
```

**Content-Type:** `application/json`

### Request

#### game\_list (v1)

**Method:** `game_list`

```json
{
    "method": "game_list",
    "agent_code": "your_agent_code",
    "agent_token": "your_agent_token",
    "provider_code": "PRAGMATIC"
}
```

**Supported providers for `game_list`:**

```
All providers
```

#### game\_list\_v2 (v2)

**Method:** `game_list_v2`

```json
{
    "method": "game_list_v2",
    "agent_code": "your_agent_code",
    "agent_token": "your_agent_token",
    "provider_code": "PRAGMATIC"
}
```

**Supported providers for `game_list_v2`:**

```
PRAGMATIC, PGSOFT, REELKINGDOM, FATPANDA, HABANERO, CQ9
```

| Field           | Type   | Required | Description                   |
| --------------- | ------ | -------- | ----------------------------- |
| `method`        | string | Yes      | `game_list` or `game_list_v2` |
| `agent_code`    | string | Yes      | Your agent code               |
| `agent_token`   | string | Yes      | Your agent API token          |
| `provider_code` | string | Yes      | Provider code                 |

### Response

#### Success — v1

```json
{
    "status": 1,
    "code": 7777777,
    "msg": "SUCCESS",
    "games": [
        {
            "id": 1,
            "game_code": "vs243mwarrior",
            "game_name": "Monkey Warrior",
            "banner": "https://.../vs243mwarrior.png",
            "status": 1,
            "bet_levels": {
                "1": 0.25,
                "2": 0.5,
                "3": 0.75,
                "4": 1,
                "5": 2.5,
                "6": 5,
                "7": 12.5,
                "8": 25,
                "9": 50,
                "10": 125
            }
        }
    ]
}
```

#### Success — v2

```json
{
    "status": 1,
    "code": 7777777,
    "msg": "SUCCESS",
    "games": [
        {
            "id": 1,
            "game_code": "vs243mwarrior",
            "game_name": {
                "en": "Monkey Warrior",
                "hi": "मंकी वारियर™",
                "vi": "Chiến Binh Khỉ",
                "ko": "몽키 워리어",
                "th": "นักรบลิง",
                "zh-hant": "酷猴戰士",
                "zh-hans": "酷猴战士"
            },
            "banner": "https://.../vs243mwarrior.png",
            "status": 1,
            "bet_levels": {
                "1": 0.25,
                "2": 0.5,
                "3": 0.75,
                "4": 1,
                "5": 2.5,
                "6": 5,
                "7": 12.5,
                "8": 25,
                "9": 50,
                "10": 125
            }
        }
    ]
}
```

#### `bet_levels`

The bets the game offers, as `level number` → `stake of one spin`. Level `1` is always the smallest bet, and the levels go up from there.

| Part  | Meaning                                                 |
| ----- | ------------------------------------------------------- |
| Key   | The bet level, counting from `1`                        |
| Value | What one spin at that level costs, in **your** currency |

The values are worked out for the agent making the request, from your currency and your bet range, so two agents can get different numbers for the same game. How many levels a game has differs per game as well — read the list, don't assume a fixed length.

Use the key as the `bet_level` of [Create Tour](https://my.nexusggr.com/app/docs/integration/freespin-tour-api/create-tour). With `"bet_levels": { "3": 0.75 }`, sending `"bet_level": 3` stakes each of that tour's free rounds at 0.75.

> **`PRAGMATIC` only for now.** `bet_levels` is the one provider that exposes its bet range so far. Every other provider leaves the field out of the game object entirely, so treat it as optional and do not build a UI that expects it everywhere. More providers are planned.

#### Failure

```json
{
    "status": 0,
    "code": 7770500,
    "msg": "Internal Error"
}
```