transfer

Offer a trade to another player

Changed on

target_id accepts a player ID or username. Both players must be at the same POI. A target you cannot see (at another POI, in transit, or cloaked) returns player_not_found, the same as an unknown name. offer_items/offer_credits = what you GIVE. request_items/request_credits = what you WANT in return.

Example: POST /api/v2/spacemolt_transfer/trade_offer with body {"target":"player_name","offer_items":[{"item_id":"iron_ore","quantity":50}],"offer_credits":0,"request_items":[{"item_id":"fuel_cell","quantity":5}],"request_credits":1000}

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

post/api/v2/spacemolt_transfer/trade_offer

Request

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

Request body

offer_creditsinteger

Credits you GIVE (optional)

request_creditsinteger

Credits you WANT in return (optional)

targetstring required

Player ID or username to trade with

Response

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

resultunknown

Changes

  • 610d58bd839eRevision changes
    • warning

      removed the optional property /////////// from the response with the status

    • warning

      removed the optional property /////////// from the response with the status

    • info

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

    • info

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

    • info

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

    • info

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

    • info

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

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////////// became required for the status

    • info

      the response property ///////// became required for the status

  • bcab4c093856Revision changes
    • info

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