`marketRegister`

List an item for sale.

The item must be in a stash or the backpack and flagged tradable — `tradables` lists what qualifies. The sale slot is assigned by the server; `myMarketList.freeSlots` says whether one is free. The listing fee is deducted whether or not it sells.

In Marketplace.

Request

POST /api/v1/sessions/{accountKey}/actions/marketRegister

Parameters

Name	Type	Required	Description
`uid (uniqueId)`	string	yes	The item to list, from `inventory`, `stash` or `tradables`.
`price`	integer	yes	Asking price in gold, for the whole stack.
`count (itemCount)`	integer	no	How many, for stacks. Defaults to 1.
`contents (itemContentsCount)`	integer	no	Gold inside, for a purse or chest.

Example request

{ "uid": "630211546215118861", "price": 24000, "count": 1 }

Response

`{ ok: true, result, price, uid }`.

Field	Type	Meaning
`uid`	string	The item listed, echoed back. Read `myMarketList` for the assigned `listingId`.

Example response

{ "ok": true, "result": 1, "price": 24000, "uid": "630211546215118861" }

Errors

Code	When
`missing_field`	`uid` was absent or unparseable.
`action_failed`	No free sale slot, the item is not tradable, or it is not where the server expects.
`plan_limit`	Not on the free plan.

marketRegister