Query Currency Offer – PlayerAuctions Help Center

GET api/v1/offers/currency/{id}

Query a single currency offer by ID.

i. Request Parameters

Path Parameters

Parameter	Type	Required	Description
id	int	Yes	Offer ID.

ii. Response Example

Success Response

{
  "code": 10000,
  "message": "",
  "requestId": "550e8400-e29b-41d4-a716-446655440000",
  "data": {
    "minUnitPerOrder": 1.000,
    "totalUnit": 100,
    "currencyPerUnit": 100.000,
    "instruction": "simple instruction",
    "deliveryGuarantee": 5,
    "discounts": [
        {
            "startPrice": 10.00,
            "discountRate": 2.00000
        },
        {
            "startPrice": 20.00,
            "discountRate": 4.00000
        },
        {
            "startPrice": 50.00,
            "discountRate": 8.00000
        }
    ],
    "categoryId": 6590,
    "currencyTypeId": 0,
    "serverId": 6590,
    "gameId": 3637,
    "price": 5.0000,
    "offerDuration": 30,
    "title": "Simple Title",
    "offerDesc": "<p>Simple Description</p",
    "offerId": 71394132,
    "isAgree": false,
    "memberId": 678694,
    "state": 1,
    "productType": "currency"
  }
}

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	Currency offer details.
data.minUnitPerOrder	decimal	Minimum unit per order.
data.totalUnit	int	Total unit available.
data.currencyPerUnit	decimal	Currency amount per unit.
data.instruction	string	Instruction for the offer.
data.deliveryGuarantee	int	Delivery guarantee for the offer.
data.discounts	array	Discount details for the offer.
data.discounts[0].startPrice	decimal	Discount start price for the offer.
data.discounts[0].discountRate	decimal	Discount rate for the offer.
data.categoryId	int	Category ID for the offer.
data.currencyTypeId	int	Currency type ID.
data.serverId	int	Server ID for the offer.
data.gameId	int	Game ID for the offer.
data.price	decimal	Offer price.
data.offerDuration	int	Offer duration in days for the offer.
data.title	string	Offer title.
data.offerDesc	string	Offer description.
data.offerId	int	Offer ID.
data.isAgree	bool	Agreement status for the offer.
data.memberId	int	Member ID for the offer.
data.state	int	State of the offer.
data.productType	string	Product type for the offer.

iii. Error Response Example

Error Response

{
  "code": 10002,
  "message": "Offer not found.",
  "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.