P_wholesaleAuctions

Returns a paginated list of publicly available wholesale auctions.

This feature is available only to accounts with the Wholesale Buyer role. Contact Eneba support if you receive a 403 or an access-denied error.

Supported arguments

The following arguments are supported by P_wholesaleAuctions query:

Field	Type	Description
`first`	Int	Returns up to the first n elements from the list
`after`	String	Returns the elements that come after the specified cursor
`search`	String	Search phrase for product name
`merchantSearch`	String	Exact merchant slug
`productIds`	[P_Uuid!]	Filter by product UUIDs
`productType`	P_ProductType	Filter by product type
`sort`	P_API_AuctionSort	Wholesale auctions sorting option

Return type

The query returns the P_API_AuctionConnection type.

Pagination

This query uses cursor-based pagination following the Relay Connection spec.

Use first to set the page size (number of auctions to return per request). Maximum value is 100.
On the first request, omit after (or pass null).
The response includes a pageInfo object:
- hasNextPage — true if more results exist beyond the current page.
- endCursor — an opaque string representing the position of the last item on the current page.
To fetch the next page, pass the previous response's pageInfo.endCursor as the after argument.
Repeat until pageInfo.hasNextPage is false.
totalCount reflects the total number of matching auctions across all pages.

Behavior

wholesaleStock is a point-in-time snapshot of available wholesale stock. It can change between this query and a subsequent purchase, so do not rely on it as a guarantee that the auction can fulfil a given quantity.
wholesalePrice.amount is returned in the currency's minor unit (cents for EUR) — divide by 100 to display.
search performs a partial match on product name.
merchantSearch requires an exact merchant slug — partial matches are not supported.
productIds accepts a list of product UUIDs and returns only auctions for those products. You can pass up to the API's page-size limit per request; use multiple paginated calls if your list is large.
productType is optional and filters to a single product category — see Product type options for valid values.
product.countriesWhitelist — when non-empty, the product may only be purchased from the listed countries (IP-based check). An empty array means no whitelist restriction.
product.countriesHardBlacklist — when non-empty, the product is inaccessible from the listed countries (IP-based check).

Product type options

The productType argument accepts the following P_ProductType values:

Value	Description
`GAME`	Full game titles.
`GIFTCARD`	Gift cards.
`GAME_POINTS`	In-game currency or points.
`DLC`	Downloadable content / expansions.
`SOFTWARE`	Non-game software.
`SUBSCRIPTION`	Subscription services.
`TOP_UP`	Generic top-up codes.
`DIRECT_TOP_UP`	Direct top-up codes (account-linked).
`MOBILE_RECHARGE`	Mobile phone recharge codes.
`EMONEY_PREPAID`	E-money / prepaid payment codes.

Sort options

The sort argument accepts the following P_API_AuctionSort values:

Value	Description
`ON_HAND_ASC`	Sort by available wholesale stock, ascending.
`ON_HAND_DESC`	Sort by available wholesale stock, descending.
`PRICE_ASC`	Sort by wholesale price, ascending.
`PRICE_DESC`	Sort by wholesale price, descending.
`PRODUCT_ASC`	Sort by product name, ascending (A → Z).
`PRODUCT_DESC`	Sort by product name, descending (Z → A).

Response fields

`P_API_Auction` (each `node`)

Field	Type	Description
`id`	`P_Uuid!`	Stable UUID for this auction listing.
`product`	`P_API_Product!`	Product details (see table below).
`wholesalePrice`	`P_Money`	Wholesale price for this auction.
`wholesaleStock`	`Int`	Point-in-time count of available wholesale stock.
`merchant`	`P_API_AuctionMerchant`	Merchant details (see table below).

`P_API_Product` (the `product` sub-object)

Field	Type	Description
`id`	`P_Uuid!`	Stable UUID for the product.
`name`	`String!`	Full product display name.
`slug`	`String!`	URL-friendly product slug.
`productType`	`P_ProductType`	Product category (e.g. `GAME`, `GIFTCARD`). See Product type options.
`releasedAt`	`P_DateTime`	Product release date (ISO 8601), or `null` if unknown.
`ean`	`String`	EAN-13 barcode, or `null` if not set.
`os`	`P_OSEnumSet`	Set of supported operating systems, or `null` if not applicable.
`regions`	`[String!]`	List of geographic regions where the product is valid (e.g. `GLOBAL`, `EUROPE`).
`regionWhitelist`	`[String!]`	Regions explicitly allowed for activation. Empty means no restriction.
`regionBlacklist`	`[String!]`	Regions explicitly blocked from activation.
`countries`	`[String]`	Countries associated with this product.
`countriesWhitelist`	`[String]`	If non-empty, the product may only be purchased from these countries (IP-based).
`countriesHardBlacklist`	`[String!]!`	Countries from which this product is inaccessible (IP-based).
`noActivationCountries`	`[String!]`	Countries where the key cannot be activated.

`P_Money` (the `wholesalePrice` sub-object)

Field	Type	Description
`amount`	`Int!`	Amount in the smallest currency unit (e.g. cents for EUR). For 14.99 EUR this value is `1499`.
`currency`	`String!`	ISO 4217 currency code (e.g. `EUR`).

`P_API_AuctionMerchant` (the `merchant` sub-object)

Field	Type	Description
`displayName`	`String!`	Merchant's display name.
`slug`	`String`	Merchant's URL slug. Use this value with the `merchantSearch` argument to filter by merchant.

`P_PageInfo`

Field	Type	Description
`hasNextPage`	`Boolean!`	Whether more pages exist when paginating forward.
`hasPreviousPage`	`Boolean!`	Whether more pages exist when paginating backward.
`startCursor`	`String`	Cursor for the first item on the current page.
`endCursor`	`String`	Cursor to pass as `after` to fetch the next page.

Example usage

Query

query getWholesaleAuctions(
  $first: Int
  $after: String
  $search: String
  $merchantSearch: String
  $productIds: [P_Uuid!]
  $productType: P_ProductType
  $sort: P_API_AuctionSort
) {
  P_wholesaleAuctions(
    first: $first
    after: $after
    search: $search
    merchantSearch: $merchantSearch
    productIds: $productIds
    productType: $productType
    sort: $sort
  ) {
    totalCount
    edges {
      cursor
      node {
        id
        product {
          id
          name
          slug
          productType
          releasedAt
          ean
          os
          regions
          regionWhitelist
          regionBlacklist
          countries
          countriesWhitelist
          countriesHardBlacklist
          noActivationCountries
        }
        wholesalePrice {
          amount
          currency
        }
        wholesaleStock
        merchant {
          displayName
          slug
        }
      }
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
    }
  }
}

First page

Variables

{ "first": 2 }

Response

{
  "data": {
    "P_wholesaleAuctions": {
      "totalCount": 150,
      "edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uLjA=",
          "node": {
            "id": "a1b2c3d4-1234-11ee-be56-0242ac120002",
            "product": {
              "id": "e5f6a7b8-5678-11ee-be56-0242ac120002",
              "name": "Call of Duty: Modern Warfare III Steam Key GLOBAL",
              "slug": "call-of-duty-modern-warfare-iii-steam-key-global",
              "releasedAt": "2023-11-10T00:00:00+00:00",
              "ean": null,
              "os": null,
              "regions": ["GLOBAL"],
              "regionWhitelist": [],
              "regionBlacklist": [],
              "countries": null,
              "countriesWhitelist": null,
              "countriesHardBlacklist": [],
              "noActivationCountries": null
            },
            "wholesalePrice": {
              "amount": 3200,
              "currency": "EUR"
            },
            "wholesaleStock": 150,
            "merchant": {
              "displayName": "Top Games Store",
              "slug": "top-games-store"
            }
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uLjE=",
          "node": {
            "id": "b2c3d4e5-2345-11ee-be56-0242ac120002",
            "product": {
              "id": "f6a7b8c9-6789-11ee-be56-0242ac120002",
              "name": "FIFA 25 EA App Key GLOBAL",
              "slug": "fifa-25-ea-app-key-global",
              "releasedAt": "2024-09-27T00:00:00+00:00",
              "ean": null,
              "os": null,
              "regions": ["GLOBAL"],
              "regionWhitelist": [],
              "regionBlacklist": [],
              "countries": null,
              "countriesWhitelist": null,
              "countriesHardBlacklist": [],
              "noActivationCountries": null
            },
            "wholesalePrice": {
              "amount": 2800,
              "currency": "EUR"
            },
            "wholesaleStock": 75,
            "merchant": {
              "displayName": "Game Keys Direct",
              "slug": "game-keys-direct"
            }
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": false,
        "startCursor": "YXJyYXljb25uZWN0aW9uLjA=",
        "endCursor": "YXJyYXljb25uZWN0aW9uLjE="
      }
    }
  }
}

Pass the endCursor from the previous response as after to fetch the next set of results.

Variables

{ "first": 2, "after": "YXJyYXljb25uZWN0aW9uLjE=" }

Response

{
  "data": {
    "P_wholesaleAuctions": {
      "totalCount": 150,
      "edges": [
        {
          "cursor": "YXJyYXljb25uZWN0aW9uLjI=",
          "node": {
            "id": "c3d4e5f6-3456-11ee-be56-0242ac120002",
            "product": {
              "id": "a7b8c9d0-7890-11ee-be56-0242ac120002",
              "name": "Minecraft Java Edition PC Key GLOBAL",
              "slug": "minecraft-java-edition-pc-key-global",
              "releasedAt": "2011-11-18T00:00:00+00:00",
              "ean": null,
              "os": null,
              "regions": ["GLOBAL"],
              "regionWhitelist": [],
              "regionBlacklist": [],
              "countries": null,
              "countriesWhitelist": null,
              "countriesHardBlacklist": [],
              "noActivationCountries": null
            },
            "wholesalePrice": {
              "amount": 1950,
              "currency": "EUR"
            },
            "wholesaleStock": 200,
            "merchant": {
              "displayName": "Digital Keys Hub",
              "slug": "digital-keys-hub"
            }
          }
        },
        {
          "cursor": "YXJyYXljb25uZWN0aW9uLjM=",
          "node": {
            "id": "d4e5f6a7-4567-11ee-be56-0242ac120002",
            "product": {
              "id": "b8c9d0e1-8901-11ee-be56-0242ac120002",
              "name": "Red Dead Redemption 2 Steam Key GLOBAL",
              "slug": "red-dead-redemption-2-steam-key-global",
              "releasedAt": "2019-12-05T00:00:00+00:00",
              "ean": null,
              "os": null,
              "regions": ["GLOBAL"],
              "regionWhitelist": [],
              "regionBlacklist": [],
              "countries": null,
              "countriesWhitelist": null,
              "countriesHardBlacklist": [],
              "noActivationCountries": null
            },
            "wholesalePrice": {
              "amount": 2100,
              "currency": "EUR"
            },
            "wholesaleStock": 40,
            "merchant": {
              "displayName": "Game Keys Direct",
              "slug": "game-keys-direct"
            }
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "hasPreviousPage": true,
        "startCursor": "YXJyYXljb25uZWN0aW9uLjI=",
        "endCursor": "YXJyYXljb25uZWN0aW9uLjM="
      }
    }
  }
}

Search by product name

Variables

{ "first": 5, "search": "Minecraft" }

Filter by merchant

Variables

{ "first": 10, "merchantSearch": "game-keys-direct" }

Sort by price ascending

Variables

{ "first": 20, "sort": "PRICE_ASC" }

Filter by product type

Variables

{ "first": 20, "productType": "GAME" }

Filter by product IDs

Variables

{
  "first": 50,
  "productIds": [
    "e5f6a7b8-5678-11ee-be56-0242ac120002",
    "f6a7b8c9-6789-11ee-be56-0242ac120002"
  ]
}

P_wholesaleAuctions

Return type

Pagination

Behavior

Product type options

Sort options

Response fields

P_API_Auction (each node)

P_API_Product (the product sub-object)

P_Money (the wholesalePrice sub-object)

P_API_AuctionMerchant (the merchant sub-object)

P_PageInfo

Example usage

Query

First page

Next page

Search by product name

Filter by merchant

Sort by price ascending

Filter by product type

Filter by product IDs

`P_API_Auction` (each `node`)

`P_API_Product` (the `product` sub-object)

`P_Money` (the `wholesalePrice` sub-object)

`P_API_AuctionMerchant` (the `merchant` sub-object)

`P_PageInfo`