- summary: Puts one lot of an inventory item on sale in the auction house at the price you choose.
- area: Game.Exchange
Puts one lot of an inventory item on sale in the auction house at the price you choose.
Kind request · Area Game.Exchange
HOW TO SELL AN ITEM
1. Open the auction house in sell mode (ExchangeBidSellerStartedEvent).
Its SellingConditions say which item types, lot sizes and level
this house accepts, and the tax you will pay.
2. Optional: get the market prices with ExchangeBidHousePriceRequest.
3. Send this request:
- object_uid = the uid of the stack in YOUR INVENTORY (not the gid);
- quantity = the lot size, one of SellingConditions.quantities
(1, 10, 100...), never more than the stack holds;
- price = the price of the WHOLE lot, in kamas.
4. In the capture the server answers, in this order:
- KamasUpdateEvent: the sale tax is taken right away;
- ExchangeBidHouseItemAddedEvent: your new sale;
- ExchangeBidHouseInListUpdatedEvent: the item's listing with the new
cheapest prices;
- ObjectDeletedEvent when the whole stack left your inventory (a
partial lot updates the stack's quantity instead);
- InventoryWeightEvent.
One request sells ONE lot. To sell several lots, send one request per lot.
When you may send it
- Requires
context_readyinferred - Raised by: the player confirms a sale in the auction-house sell window proven
Related messages
- You will then receive
ExchangeBidHouseItemAddedEventobserved — the server confirms the new sale with the item, its price and its delay
Fields
| # | Field | Type | Meaning | You set it |
|---|---|---|---|---|
| 1 | object_uid | int32 | The stack to sell: its uid in your inventory. Observed: 8567885 | required |
| 2 | quantity | int32 | The lot size to put on sale: one of the house's quantities (1, 10, 100...). Observed: 1 | required |
| 3 | price | int64 | The asking price of the whole lot, in kamas. (kamas) Observed: 1 | required |