- summary: Buys one lot of one auction-house listing at the price you were shown.
- area: Game.Exchange
Buys one lot of one auction-house listing at the price you were shown.
Kind request · Area Game.Exchange
HOW TO BUY
1. Open the auction house in buy mode (ExchangeBidBuyerStartedEvent).
2. Get the item's listings: ExchangeBidHouseSearchRequest ->
ExchangeTypesItemsExchangerDescriptionForUserEvent. Each
BidExchangerObject carries an object_uid and one price per lot
size.
3. Send this request:
- object_uid = the listing you buy;
- quantity = the lot size you buy (the client sends the size of the
row the player clicked: 1, 10, 100...);
- price = that lot's price exactly as listed. The client sends the price
it displayed; it never computes one.
4. One request buys ONE lot. To buy several lots, send several requests,
each with fresh data.
WHAT COMES BACK (in this order in captures)
- ExchangeBidHouseInListUpdatedEvent for that listing if you follow its
item (its remaining lots and prices);
- KamasUpdateEvent with your new kamas;
- ObjectAddedEvent with the item in your inventory;
- InventoryWeightEvent and a chat notice (TextInformationEvent);
- ExchangeBidHouseBuyResultEvent with bought = true.
If bought is false, nothing was bought. Refresh the listings (search again)
before retrying, because a stale uid or price will keep failing.
When you may send it
- Requires
context_readyinferred - Raised by: the player confirms a purchase in the auction-house buy window proven
Related messages
- You will then receive
ExchangeBidHouseBuyResultEventobserved — the server always closes the purchase with a result for the listing you named
Fields
| # | Field | Type | Meaning | You set it |
|---|---|---|---|---|
| 1 | quantity | int32 | The lot size you buy (1, 10, 100, ...): the row the player picked. Observed: 1 | required |
| 3 | object_uid | int32 | The listing to buy: an object_uid from the item's listings. Observed: 914 | required |
| 5 | price | int64 | The price of that lot exactly as listed, in kamas. (kamas) Observed: 4 | required |