`priceCheck`

What one item is currently going for.

Samples the market's cheapest and dearest pages for the item and records the reading, so `priceHistory` can show it moving. Only listings whose rarity matches exactly are counted — the game's own filter is loose, and without that guard a gem quality would contaminate the reading. Per-unit figures are the ones to price a stack with: a 6-stack at 660g and a single at 150g are 110/ea against 150/ea.

In Marketplace.

Request

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

Parameters

Name	Type	Required	Description
`tag (itemId, item_id)`	string	yes	The item's tag, e.g. `AdventurerBoots`.
`rarity`	string	no	Restrict to one rarity. Strongly recommended — prices differ by an order of magnitude across tiers.
`label`	string	no	A display name to record with the reading; the tag is used when omitted.

Example request

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

Response

The recorded reading: low, average, high, their per-unit forms, the sample size and recent history.

Field	Type	Meaning
`lowest`	integer\|null	Cheapest whole-listing price found.
`unitLowest`	integer\|null	Cheapest per-unit price — what to compare a stack against.
`sample`	integer	How many listings the reading is based on. 0 means nothing was listed.
`history[]`	object[]	Previous readings for this item and rarity, newest first.
`note`	string	Present when `sample` is 0, saying so.

Example response

{
  "ok": true,
  "tag": "AdventurerBoots",
  "rarity": "Legendary",
  "label": "Adventurer Boots",
  "lowest": 19500,
  "average": 24800,
  "highest": 31000,
  "unitLowest": 19500,
  "unitAverage": 24800,
  "unitHighest": 31000,
  "sample": 14,
  "checkedAt": 1755734412.44,
  "history": [
    { "lowest": 20100, "average": 25400, "highest": 32000, "sample": 12, "checkedAt": 1755648012.1 }
  ]
}

Errors

Code	When
`action_failed`	No character is in the lobby, or the market read timed out.
`plan_limit`	Not on the free plan.

priceCheck