ship

Place a standing buy order for a ship class at this base

Changed on

Escrows your offered price plus sales tax. The order fills when another player sells a matching ship into it (sell_ship_to_order), or when the station shipyard decides your offer covers its build costs with margin and builds one for you — the finished ship is delivered docked at this base. Requires a base with a shipyard. One open order per ship class per base. Cancel anytime with cancel_ship_buy_order for a full refund. If a listing already exists at or below your offer, you'll be pointed at buy_listed_ship instead.

Example: POST /api/v2/spacemolt_ship/place_ship_buy_order with body {"id":"hauler","price":15000}

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

post/api/v2/spacemolt_ship/place_ship_buy_order

Request

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

Request body

idstring required

Ship class to order (use catalog type=ships to see classes)

priceinteger required

Offered price in credits (escrowed with sales tax until filled or cancelled)

Response

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

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