Games

The Games API provides access to the list of available games and their currencies that you can create offers for.

Get Games List

Retrieve a list of all available games.

Endpoint

GET /v1/games

Query Parameters

Parameter	Type	Required	Description
filters[offer_type]	string	No	Filter games by offer type. Values: items, currency, accounts
sort[field]	string	No	Sort field. Values: name
sort[direction]	string	No	Sort direction. Values: asc, desc

Request Example

curl -X GET "https://sellerapi.ggchest.com/v1/games?filters[offer_type]=accounts&sort[field]=name&sort[direction]=asc" \
  -H "X-API-KEY: your-api-key-here"

Response Example

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "World of Warcraft",
    "icon": {
      "id": "660e8400-e29b-41d4-a716-446655440001",
      "path": "https://cdn.ggchest.com/icons/wow.png"
    },
    "resources": {
      "icon": {
        "id": "660e8400-e29b-41d4-a716-446655440001",
        "path": "https://cdn.ggchest.com/icons/wow.png"
      },
      "cover": {
        "id": "770e8400-e29b-41d4-a716-446655440002",
        "path": "https://cdn.ggchest.com/covers/wow.jpg"
      }
    }
  },
  {
    "id": "550e8400-e29b-41d4-a716-446655440003",
    "name": "Final Fantasy XIV",
    "icon": {
      "id": "660e8400-e29b-41d4-a716-446655440004",
      "path": "https://cdn.ggchest.com/icons/ffxiv.png"
    },
    "resources": {
      "icon": {
        "id": "660e8400-e29b-41d4-a716-446655440004",
        "path": "https://cdn.ggchest.com/icons/ffxiv.png"
      },
      "cover": {
        "id": "770e8400-e29b-41d4-a716-446655440005",
        "path": "https://cdn.ggchest.com/covers/ffxiv.jpg"
      }
    }
  }
]

Response Fields

Field	Type	Description
id	string	Unique game identifier (UUID)
name	string	Game name
icon	object|null	Game icon object
icon.id	string|null	Icon identifier
icon.path	string|null	URL to the icon image
resources	object	Game resources (icons, covers)
resources.icon	object|null	Game icon resource
resources.cover	object|null	Game cover image resource

Get Game Currencies

Retrieve available currencies for a specific game.

Endpoint

GET /v1/games/{id}/currency

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Game ID (UUID)

Request Example

curl -X GET "https://sellerapi.ggchest.com/v1/games/550e8400-e29b-41d4-a716-446655440000/currency" \
  -H "X-API-KEY: your-api-key-here"

Response Example

[
  {
    "id": "880e8400-e29b-41d4-a716-446655440010",
    "name": "Gold",
    "nominal": "1000",
    "icon": {
      "id": "990e8400-e29b-41d4-a716-446655440011",
      "path": "https://cdn.ggchest.com/icons/gold.png"
    }
  },
  {
    "id": "880e8400-e29b-41d4-a716-446655440012",
    "name": "Silver",
    "nominal": "100",
    "icon": {
      "id": "990e8400-e29b-41d4-a716-446655440013",
      "path": "https://cdn.ggchest.com/icons/silver.png"
    }
  }
]

Response Fields

Field	Type	Description
id	string	Currency identifier (UUID)
name	string	Currency name
nominal	string	Currency nominal value
icon	object	Currency icon
icon.id	string	Icon identifier
icon.path	string	URL to the icon image

Error Responses

404 Not Found

Returned when the game ID is invalid or the game doesn't exist.

{
  "message": "Page not found"
}