faction_commerce

Create a buy order on behalf of your faction (credits from faction treasury)

Changed on

Credits are escrowed from the faction treasury. Purchased items go to faction storage. Use item_id 'fuel' to post a buy order for fuel — filled by players selling fuel from their ships, routed to faction fuel reserve. Requires manage_treasury permission. Accepts item_id or item name. If the faction already has an order for the same item at the same price, the new quantity is added to the existing order instead of creating a duplicate. Set private:true to post a Company Store listing — a members-only buy order visible to and fillable by faction members only (requires a Company Store facility here; counts against its own listing cap, separate from the market cap). Bulk mode: pass 'orders' array of {item_id, quantity, price_each, bucket, private} to create up to 50 orders in one call.

Example: POST /api/v2/spacemolt_faction_commerce/create_buy_order with body {"item_id":"iron_ore","quantity":100,"price_each":4}

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

post/api/v2/spacemolt_faction_commerce/create_buy_order

Request

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

Request body

bucketstring

Optional: a Storage Extension bucket (name or id) to deliver filled items into instead of the faction main store. Not valid for fuel orders.

item_idstring

ID of the item to buy for faction storage. Required for single mode.

price_eachinteger

Maximum price per unit in credits. Required for single mode.

privateboolean

Optional: post a Company Store listing — a members-only buy order visible to and fillable by faction members only. Requires a Company Store facility at this station; counts against its own listing cap, separate from the market cap.

quantityinteger

Number of items to buy. Required for single mode.

Response

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

resultunknown

Changes

    • info

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

    • info

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