`marketTransfer`

Claim one listing — its payout if it sold, the item back if it expired.

What it does depends on the listing's state: a sold listing pays gold into your containers, an expired one returns the item to your stash. A listing that is still live must be cancelled first. The claim window is finite — a listing left in `transfer_expired` is lost, and no call recovers it.

In Marketplace.

Request

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

Parameters

Name	Type	Required	Description
`listingId (listing_id)`	string	yes	From `marketList` or `myMarketList`. It exceeds 2^53, so it travels as a string — parsing it as a JSON number will corrupt it.

Example request

{ "listingId": "9007199254740994" }

Response

`{ ok: true, kind, claimed, deposited, listingId }`.

Field	Type	Meaning
`kind`	string	`sold` when gold was claimed, `expired` when an item was returned.
`claimed`	integer	Gold banked, for a sold listing.
`deposited[]`	object[]	Which containers the gold went into, and how much each took.

Example response

{
  "ok": true,
  "result": 1,
  "kind": "sold",
  "claimed": 8000,
  "deposited": [ { "container": "GoldCoinChest", "added": 8000 } ],
  "listingId": "9007199254740994"
}

Errors

Code	When
`action_failed`	The listing is still live (cancel it first), the claim window has expired, or every gold container is full.
`plan_limit`	Not on the free plan.

marketTransfer