Query Marketplace Top Up Offers – PlayerAuctions Help Center

Gethttps://seller-api.playerauctions.com/api/v1/olp/topup

Query the paged list of published top-up offers for a game. Offers are returned in descending order of offer ID (newest first).

i. Request Example

https://seller-api.playerauctions.com/api/v1/olp/topup?gameId=9479&pageIndex=1&pageSize=20&categoryId=&serverId=

ii. Request Parameters

Query Parameters

Parameter	Type	Required	Description
gameId	int	Yes	Game ID.
pageIndex	int	No	Page number. Default: 1. Values less than 1 are treated as 1.
pageSize	int	No	Number of items per page. Default: 20. Maximum: 100.
categoryId	int	No	Top-up category ID to filter by.
serverId	int	No	Server ID to filter by. You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint. Offers without a category are always included.

iii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "count": 24,
    "items": [
      {
        "offerId": 71394136,
        "offerTitle": "500 Gems Top Up - Instant",
        "sellerName": "BestSeller05",
        "sellerLevel": 5,
        "sellerRating": 4.95,
        "price": 9.99,
        "deliveryTime": "In 20 Minutes",
        "categoryServer": "Asia",
        "categoryFaction": "",
        "minUnitPerOrder": 1,
        "perUnit": "500+50",
        "categoryName": "Gems"
      }
    ]
  }
}

Error Response

{
  "code": 10002,
  "message": "Invalid parameter.",
  "requestId": "550e8400-e29b-41d4-a716-446655440000"
}

iv. Response Parameters

Parameter	Type	Description
code	int	Response code. 10000 indicates success; other values indicate an error.
message	string	Response message. Contains error details on failure.
requestId	string	Unique identifier for the request, used for tracking.
data	object	Response payload. Returned only when the request succeeds.
data.count	int	Total number of offers that match the filters.
data.items	array	Offer list of the current page.
└─ offerId	int	Offer ID.
└─ offerTitle	string	Offer title.
└─ sellerName	string	Seller name.
└─ sellerLevel	int	Seller level.
└─ sellerRating	decimal	Weighted feedback rating of the seller.
└─ price	decimal	Price per unit in USD.
└─ deliveryTime	string	Committed delivery time of the offer, for example `In 20 Minutes`.
└─ categoryServer	string	Server name of the offer. Null when the offer has no server.
└─ categoryFaction	string	Faction name of the offer. Null when the offer has no faction.
└─ minUnitPerOrder	decimal	Minimum units per order.
└─ perUnit	string	Quantity per unit. For categories with a fixed quantity, the value is in the format `{fixedQuantity}+{extraQuantity}`, for example `500+50`. Null when the offer has no category.
└─ categoryName	string	Top-up category name. Null when the offer has no category.