Create Currency Offer – PlayerAuctions Help Center

POST api/v1/offers/currency

Create a new currency offer.

i. Request Example


{
  "gameId": 3637,
  "title": "Good Price Title",
  "offerDesc": "<p>Good Price Description</p>",
  "offerDuration": 30,
  "agreeCheck": true,
  "price": 5,
  "serverId": 3638,
  "categoryId": 3638,
  "instruction": "simple instruction",
  "deliveryGuarantee": 5,
  "totalUnit": 100,
  "minUnitPerOrder": 1,
  "discounts": [
    {
      "startPrice": 10,
      "discountRate": 2
    },
    {
      "startPrice": 20,
        "discountRate": 4
    },
    {
      "startPrice": 50,
      "discountRate": 8
    }
  ],
  "currencyPerUnit": 100
}

ii. Request Parameters

Body Parameters

Parameter	Type	Required	Description
gameId	int	Yes	Game ID.
price	decimal	Yes	Offer price.
offerDuration	int	Yes	Offer duration in days.
title	string	Yes	Offer title.
offerDesc	string	No	Offer description.
minUnitPerOrder	int	Yes	Minimum units per order.
totalUnit	int	Yes	Total units available.
currencyPerUnit	int	Yes	Currency amount per unit.
instruction	string	No	Delivery instructions.
deliveryGuarantee	int	Yes	Delivery guarantee time. You can get the list of available options from the api/v1/games/{id}/{type}/deliveryTimes endpoint.
categoryId	int	Yes	Category ID.
serverId	int	Yes	Server ID.
discounts	array	No	Discount rules for the offer.
discounts[0].startPrice	int	Yes	Starting price for the discount.
discounts[0].discountRate	int	Yes	Discount rate for the discount.

iii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "offerId": 71394132,
    "navigateURL": "https://www.playerauctions.com/lol-riot-points/71394132c!simple-title/",
    "title": "Simple Title",
    "productType": "currency",
    "gameName": "League of Legends",
    "productName": "Currency",
    "screenShot": "https://cdn-image.azureedge.net/title-image/liutest6/202606090157435744.png",
    "recentLable": "LOL Riot Points",
    "recentURL": "/offerCreation/?gameid=3637&type=currency",
    "imageBlacklist": ""
  }
}

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.offerId	int	Created offer ID.
data.navigateURL	string	Created offer URL.
data.title	string	Offer title.
data.productType	string	Product type.
data.gameName	string	Game name.
data.productName	string	Product name.
data.screenShot	string	Screen shot URL for the offer.
data.recentLable	string	Recent label for the offer.
data.recentURL	string	Recent URL for the offer.
data.imageBlacklist	string	Image blacklist for the offer.

iv. Error Response Example

Error Response

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

Common Error Codes

Parameter	Type	Description
code	int	Error code. Common values: 10002 (Invalid parameter), 50001 (Internal server error).
message	string	Detailed error message explaining what went wrong.
requestId	string	Unique identifier for the request, used for tracking.