---
title: "Purchase Cargo"
method: POST
path: "/my/ships/{shipSymbol}/purchase"
tags: ["Fleet"]
---

# Purchase Cargo

`POST /my/ships/{shipSymbol}/purchase`

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.

## Path parameters

- `shipSymbol` string, required

## Request body

- object
  - `symbol` TradeSymbolJson, required — unresolved $ref
  - `units` integer, required — Amounts of units to purchase.

## Response `201`

Purchased goods successfully.

- object
  - `data` object, required
    - `agent` AgentJson, required — unresolved $ref
    - `cargo` ShipCargoJson, required — unresolved $ref
    - `transaction` MarketTransactionJson, required — unresolved $ref

---

[API](https://skmtc.net/spacetradersapi/apis/spacetraders-api.md) · [All operations](https://skmtc.net/spacetradersapi/apis/spacetraders-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/spacetradersapi/spacetraders-api/revisions/197cf9b9a2b6/schema)