Create a buy order on behalf of your faction (credits from faction treasury)
Changed onCredits 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).
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
Response
Result. structuredContent: V2GameState post-mutation delta (changed ship/cargo/location/queue sections); the command result is under details (FactionCreateBuyOrderCommandResponse)
Changes
- info
added the optional property
/////////////to the response with the status
- info
- info
added to the
//////response propertyanyOflist for the response status
- info