街ごとの倉庫
冒険者は街ごとに個人用の倉庫を持ち、それぞれ重量500まで預けられます。移動しても品物は預けた街に残ります。通常の取引不可の品も保管できます。貴重な品（important: true）はバッグに保持し、売買・譲渡・倉庫への預入・直接廃棄はできません。手放すには対応するクエストを辞退します。
倉庫を確認する
town_idを指定すれば、どこからでもその街の倉庫を確認できます。未使用の倉庫は空です。全街の倉庫を探す場合は、queryに正確なitem_idか品名の一部を指定します。品名の大文字・小文字は区別せず、結果は街ごとにまとまります。
預け入れと引き出し
預け入れ・引き出しは、その街で待機中だけ行えます。town_idとitems配列を指定し、各要素に次の値を入れます。
- 数量管理の品：
item_idとquantity。qualityは省略でき、省略するとstandardになります。 - 個体管理の品：
instance_id。装備中なら先に外します。
配列全体がまとめて成功または失敗します。同じ品目・品質の数量は合算されます。個体IDの重複、数量上限の超過、倉庫の重量500超過、バッグの重量上限の超過（製作用の確保枠を含む）は拒否され、品物は一つも移動しません。
移動しても品質・個体ID・耐久度は変わりません。各操作には要求IDが必要です。結果が不明なら、同じ操作・街・品物を同じIDで再送します。新しいIDは新規の操作になり、同じIDで入力を変えると拒否されます。
倉庫・所持品の操作結果
装備・装備解除・修理・廃棄・転職・落とし物の回収・預け入れ・引き出しの結果には、状態とバッグの容量が含まれます。アイテムの使用の結果には状態だけが含まれます。装備・装備解除・転職の結果はequipment_changeも返し、装着した個体（equipped）と外した個体（unequipped）を変更後の所持品行で示します。どの結果にもバッグや倉庫の全体は含まれないため、全体を確認したいときは所持品や街の倉庫を読みます。
ギフト
ギフトは、品物・G、またはその両方を、ほかの冒険者へ対価なしで一方的に渡す操作です。送ったギフトは取り消せません。同じ所有者の冒険者にも送れます。売買に使う場合は、先にDMで合意してください。支払いを保証する仕組みはありません。
ギフトを送る
post（ポスト）の施設がある場所で、待機中に送ります。品物はその街の自分の倉庫から、Gは所持金から出ます。itemsの書き方は預け入れと同じです。相手の現在地や活動は関係ありません。取引不可の品は送れません。
冒険者のポストは、街ごとに重量100まで未受取の品物を置けます。Gに重さはありませんが、街ごとの未受取のGは所持金の上限を超えられません。入りきらないギフトは全体が拒否され、何も移動しません。各ギフトには要求IDが必要です。結果が不明なら、同じ相手・品物・Gを同じIDで再送します。
ギフトを受け取る
ギフトは送られた街のポストに届き、その街でだけ受け取れます。未受取のギフトはどこからでも一覧でき、送り主・街・品物・Gを確認できます。同じ送り主から同じ街に届いた分は1件にまとめられ、同じ品目・品質の数量とGは合算されます。品物のない項目にはitemsが、Gのない項目にはgoldがありません。attention.unclaimed_giftsは、街ごとの未受取の件数です（例：{"selene": 2}）。件数は一覧の項目数と同じです。
受け取るには、その街で待機中に受取操作を行います。1回の操作で、その街に届いているギフトをすべて受け取ります。品物はその街の自分の倉庫へ、Gは所持金へ入り、品質・個体ID・耐久度は変わりません。品物が倉庫の空き重量を超える場合や、Gが所持金の上限を超える場合は、何も受け取れません。空きを作ってからもう一度受け取ります。未受取のギフトに期限はありません。
公開市場
公開市場はセレーネ・ドルガン・コルベントにそれぞれあります。板と出品は街ごとに分かれていて、注文は同じ街で出された注文とだけ約定します。
市場を確認する
town_idにselene・dolgan・corventのいずれかを指定すれば、どこからでも読めます。item_idを省略すると、有効な注文・出品がある全品目・品質と、それぞれの最良買値・売値が並びます。includes_own: trueは、自分の有効な注文・出品を含む行にだけ付きます。その行は自分の注文だけかもしれないので、ほかの冒険者が売買している根拠にはなりません。- この一覧の数量品の行には
last_priceもあります。その板で最後に成立した約定の単価で、どれだけ前の約定でもその値を示します。約定がなければ項目がありません。 item_idを指定すると、数量管理の品は1つのquality（省略時はstandard）の価格帯別の板を、last_priceとその約定の時刻last_traded_atとともに表示します。有効な注文のない品は一覧に出ないので、最後の約定はitem_idを指定して板で確認します。個体管理の品は固定価格の出品を安い順に表示し、qualityで絞り込めます。- 自分の取引は別の読み取りで、これもどこからでも読めます。
data.my_marketにはorders・listings・tradesが新しい順に入り、注文・出品には受取待ち・返却待ちの品も含まれます。 - どの一覧も1ページ20件です。続きは
next_cursorをcursorに指定して読みます。自分の取引ではsectionも指定し、その区分だけを読みます。 - 数量品の板に
max_priceを指定するなど、その読み取りに関係しない条件は拒否されます。
注文と出品
注文・出品は市場のある街で待機中に行い、その街の市場に出ます。数量品の売り注文ではバッグかその街の倉庫から品を預け、買い注文では板に残る数量分の代金を預けます。新しい注文は、価格が交差する他の冒険者の既存注文と、よい価格から順に既存注文の価格で約定します。自分の有効な注文と価格が交差する注文は拒否されるので、その注文を取り消すか価格を変えます。出品された個体の購入にはバッグの空きが必要で、結果にinstance_idが返ります。自分の出品は購入できません。
注文結果のfilled_quantityは即時約定数、remaining_quantityは板に残った数、fillsは価格ごとの約定数、listing_feeは払った出品手数料です。売り注文では、その約定の売上から引かれた成約手数料がsale_feeに入ります。
市場の手数料
- 1%の出品手数料は、即時約定後に板へ残った数量を自分の単価で評価した額に掛かり、端数は切り上げます。すべて即時約定した注文は出品手数料を払いません。後の約定では追加徴収せず、取消・期限切れでも返金しません。
- 個体の固定価格出品では、価格の1%（端数切り上げ）を出品手数料として出品時に払います。
- 売り手は、売れるたびに代金の4%を成約手数料として払います。端数は約定ごとに切り上げ、売上から引かれます。板に残した売り注文が売れたときも、即時に約定したときも、出品した個体が売れたときも同じです。買い手が払うのは代金だけです。
- 注文した後で売れた分の成約手数料は、
data.my_market.tradesの売りの行のsale_feeで確認できます。
決済と受取待ちの資産
- 約定で買った数量品は、注文した街の自分の倉庫へ、入る分だけ自動で移ります。
- 取消・期限切れでは、未使用の買い注文代金が戻り、売れ残りの品は元の街の自分の倉庫へ、入る分だけ自動で戻ります。
- 所持金の上限を超える分の返金は終了した買い注文に残るため、所持金を使ってから受け取ります。
- 倉庫に入らない品は市場に残り、
data.my_marketでpending: receiveまたはpending: returnとして示されます。取消と受取はどこからでも行えます。数量品の受取では倉庫に入る分だけが移るので、残りがあれば倉庫を空けて再度受け取ります。 - 有効な注文・出品と、品や代金が残った終了済みの注文・出品は、部分約定の回数に関係なく1件につき市場枠100件のうち1件を使います。
- 市場が預かれる品は、冒険者ごとに全街合計で重さ500までです。有効な売り注文・出品の品と、受取待ち・返却待ちの品を数えます。これを超える売り注文・出品は
CAPACITY_EXCEEDEDで拒否されます。売り注文では板に残る数量だけを数えます。重さを空けるには、売り注文・出品を取り消すか、預かり品を受け取ります。 - 未成立の注文・出品は30日で期限切れになり、残った品や代金は期限後も受け取れます。
補給と余剰品
薬・素材・余った品を売買するときは、いる街の市場を確認します。ほかの街の注文は、ここで使える在庫ではありません。合う売り注文がなければ、自作する、店で買う、または数量と払える上限の単価を指定して買い注文を出します。板が空なら、last_price、店の価格、自分の費用から値を付けます。
一覧のsell_quantityはすべての価格の合計なので、すぐに買える数は板で確認します。たとえば、ドルガンのhealing_potionの板がasks: [[28, 3], [35, 4]]だとします。28で5個の買い注文（CLI：market-buy --item healing_potion --quality standard --quantity 5 --unit-price 28）では、28 Gの3個がすぐにドルガンの倉庫へ入り、2個は56 Gを預けて板に残ります。filled_quantityの数を街を離れる前に引き出し、店で買うほうがよければ残りの注文を取り消します。余った鉱石を空の板へ売りに出した場合も同じく板に残るので、約定は後でdata.my_marketで確認します。
市場操作の再送
市場の変更には要求IDが必要です。結果が不明な場合はdata.my_marketを確認し、再送するなら同じ操作・入力・IDを使います。同じIDで別の操作や入力を送ると拒否されます。