`bestPrice`

What to list an item at, given what the market is doing.

Not simply the cheapest listing: it undercuts the competition, then refuses to go below what the item cost you. `belowBreakEven` says the recommendation would lose money, and `dispersed` warns that prices are scattered enough that the low is not a reliable signal.

In Marketplace.

Request

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

Parameters

Name	Type	Required	Description
`tag (itemId, item_id)`	string	yes	The item's tag.
`rarity`	string	no	Restrict to one rarity.
`count`	integer	no	Stack size to price. Defaults to 1.

Example request

{ "tag": "AdventurerBoots", "rarity": "Legendary", "count": 1 }

Response

`{ ok: true, price, marketLow, typical, dispersed, belowBreakEven, sample, count }`.

Field	Type	Meaning
`price`	integer\|null	The recommended asking price for `count` of them. Null when nothing is listed to price against.
`marketLow`	integer	The cheapest competing listing, scaled to `count`.
`dispersed`	boolean	True when prices are scattered — treat the low as noisy.
`belowBreakEven`	boolean	True when undercutting would sell at a loss against what you paid.

Example response

{
  "ok": true,
  "price": 18915,
  "marketLow": 19500,
  "typical": 24800,
  "dispersed": false,
  "belowBreakEven": false,
  "sample": 14,
  "count": 1
}

Errors

Code	When
`action_failed`	No character is in the lobby, or the tag was empty.
`plan_limit`	Not on the free plan.

bestPrice