GEThttps://seller-api.playerauctions.com/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,
"memberId": 678694,
"state": 1,
"productType": "currency"
}
}Error Response
{
"code": 10002,
"message": "Offer not found.",
"requestId": "550e8400-e29b-41d4-a716-446655440000"
}iii. 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. |
| └─ minUnitPerOrder | decimal | Minimum unit per order. |
| └─ totalUnit | int | Total units available. |
| └─ currencyPerUnit | decimal | Currency amount per unit. |
| └─ instruction | string | Instructions for the offer. |
| └─ deliveryGuarantee | int | Delivery guarantee for the offer. |
| └─ discounts | array | Discount details for the offer. |
| └─ └─ startPrice | decimal | Discount start price for the offer. |
| └─ └─ discountRate | decimal | Discount rate for the offer. |
| └─ categoryId | int | Faction ID (The {id} of the leaf node). You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint. |
| └─ currencyTypeId | int | Currency type ID. |
| └─ serverId | int | Server ID {id}. You can get the server's tree-structured data from the api/v1/games/{id}/{type}/servers endpoint. |
| └─ gameId | int | Game ID. |
| └─ price | decimal | Price per unit. |
| └─ offerDuration | int | Offer duration in days. |
| └─ title | string | Offer title. |
| └─ offerDesc | string | Offer description. |
| └─ offerId | int | Offer ID. |
| └─ memberId | int | Member ID for the offer. |
| └─ state | int | Current state of the offer (0 closed, 1 active, 3 hidden). |
| └─ productType | string | Product type for the offer. |