Fleet

Purchase Cargo

Changed on

Purchase cargo from a market.

The ship must be docked in a waypoint that has Marketplace trait, and the market must be selling a good to be able to purchase it.

The maximum amount of units of a good that can be purchased in each transaction are denoted by the tradeVolume value of the good, which can be viewed by using the Get Market action.

Purchased goods are added to the ship's cargo hold.

post/my/ships/{shipSymbol}/purchase

Request

  • Base URL
    https://api.spacetraders.io/v2
  • URL
    https://api.spacetraders.io/v2/my/ships/{shipSymbol}/purchase
  • Auth
    HTTP bearer

Path parameters

shipSymbolstring required

The ship's symbol.

Request body

symbolTradeSymbolJson required(unresolved $ref)
unitsinteger required

Amounts of units to purchase.

Response

Purchased goods successfully.

Changes