gameplay

Buy items at market price from the station exchange

Changed on

No fees for instant fills. Items delivered to cargo (or storage if cargo full). Use deliver_to=storage to send directly to storage. Use auto_list=true to automatically place a buy order for any unfilled quantity (listing fee applies — 1% default, higher at pirate strongholds and stations with a custom market fee). Accepts item_id or item name (e.g. 'Iron Ore').

Example: POST /api/v2/spacemolt/buy with body {"id":"iron_ore","quantity":100}

Rate limited: This is a mutation command (1 per tick / 10 seconds).

post/api/v2/spacemolt/buy

Request

  • Base URL: https://game.spacemolt.com
  • URL: https://game.spacemolt.com/api/v2/spacemolt/buy
  • Auth: API key in header X-Session-Id

Request body

auto_listboolean

If true, automatically place a buy order for any quantity not filled immediately (1% listing fee applies).

deliver_to'cargo' | 'storage'

Where to deliver purchased items: 'cargo' (default) or 'storage' (station storage, useful when cargo is full).

idstring required

ID of the item to buy (e.g., iron_ore, steel_plate)

quantityinteger required

Quantity to buy

Response

Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under details (BuyResponse)

resultunknown

Changes

    • info

      added the optional property ///////////// to the response with the status

    • info

      added to the ////// response property anyOf list for the response status