SpaceTraders

https://docs.spacetraders.io
Admin
SpaceTraders is a headless, open-universe, space-themed economic game that provides HTTP API...
Tokens:25,430
Snippets:372
Trust Score:6.8
Update:2 months ago
Show doc for...
Tokens:
Raw
### Documentation: Quickstart Guide

Source: https://docs.spacetraders.io/resources/changelog

Updated the quickstart guide with information about the new probe.

```text
Updated quickstart guide with new probe (8dbbb5d4)
```

--------------------------------

### cURL

Source: https://docs.spacetraders.io/getting-started

Test API endpoints directly in your browser with our Quickstart guide.

```bash
curl 'https://api.spacetraders.io/v2'
```

--------------------------------

### Get agent data

Source: https://docs.spacetraders.io/quickstart/new-game

This cURL command retrieves the data for your agent, including starting faction, ships, and faction contract. Replace AGENT_TOKEN with your actual agent token.

```curl
curl 'https://api.spacetraders.io/v2/my/agent' \ 
 --header 'Authorization: Bearer AGENT_TOKEN'
```

--------------------------------

### GET /systems

Source: https://docs.spacetraders.io/openapi

Retrieves a list of all systems.

```APIDOC
## GET /systems

### Description
List all systems in the universe.

### Method
GET

### Endpoint
https://api.spacetraders.io/v2/systems
```

--------------------------------

### View your starting waypoint location

Source: https://docs.spacetraders.io/quickstart/new-game

This cURL command retrieves the details of a specific waypoint. You will need to replace :systemSymbol and :waypointSymbol with the actual symbols for the system and waypoint you want to view.

```curl
curl 'https://api.spacetraders.io/v2/systems/:systemSymbol/waypoints/:waypointSymbol'
```

--------------------------------

### Generate TypeScript Client Library

Source: https://docs.spacetraders.io/api-guide/open-api-spec

Example command to generate a TypeScript client library using the OpenAPI Generator with the bundled specification.

```bash
openapi-generator generate \
 -i https://spacetraders.io/SpaceTraders.json \
 -o packages/spacetraders-sdk \
 -g typescript-axios \
 --additional-properties=npmName="spacetraders-sdk" \
 --additional-properties=npmVersion="2.3.0" \
 --additional-properties=supportsES6=true \
 --additional-properties=withSeparateModelsAndApi=true \
 --additional-properties=modelPackage="models" \
 --additional-properties=apiPackage="api"

```

--------------------------------

### Get Ship Cargo

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command retrieves the current cargo manifest of your ship.

```bash
curl 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/cargo'
```

--------------------------------

### Navigate to Asteroid

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command navigates your ship to a target waypoint.

```bash
curl --request POST \
  --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/navigate' \
  --header 'Content-Type: application/json' \
  --data '{ \
    "waypointSymbol": "" \
   }'
```

--------------------------------

### Internal: Module Install and Agent Refactoring

Source: https://docs.spacetraders.io/resources/changelog

Added module install command, ship install/remove error codes, and refactored agent registration.

```text
Added module install command, ship install / remove error codes, and refactored register agent (6df4b927, 3adb05e0, 94ff962b, 751955d4)
```

--------------------------------

### Extract Ores and Minerals

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command initiates the extraction of ores and minerals from an asteroid.

```bash
curl --request POST \
  --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/extract'
```

--------------------------------

### GET /systems/{systemSymbol}

Source: https://docs.spacetraders.io/openapi

Retrieves details for a specific system.

```APIDOC
## GET /systems/{systemSymbol}

### Description
Get the details of a specific system.

### Method
GET

### Endpoint
https://api.spacetraders.io/v2/systems/{systemSymbol}

### Parameters
#### Path Parameters
- **systemSymbol** (string) - Required - The symbol of the system.
```

--------------------------------

### Dock Ship

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command docks your ship at the current waypoint.

```bash
curl --request POST \
  --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/dock'
```

--------------------------------

### Accept Your Contract

Source: https://docs.spacetraders.io/quickstart/first-mission

This cURL command shows how to accept a contract, which will provide an upfront credit payment and a final amount upon delivery.

```shell
curl --request POST \
 --url 'https://api.spacetraders.io/v2/my/contracts/:contractId/accept'
```

--------------------------------

### View market data

Source: https://docs.spacetraders.io/quickstart/sell-cargo

Send a GET request to the market endpoint to view available goods, their prices, and trade volumes.

```curl
curl 'https://api.spacetraders.io/v2/systems/:systemSymbol/waypoints/:asteroidWaypointSymbol/market'
```

--------------------------------

### POST /register

Source: https://docs.spacetraders.io/openapi

Creates a new agent and ties it to an account, granting an authorization token and starting resources.

```APIDOC
## POST /register

### Description
Creates a new agent and ties it to an account. The agent symbol must be 3-14 characters and will be used to represent your agent.

### Method
POST

### Endpoint
https://api.spacetraders.io/v2/register

### Request Body
- **symbol** (string) - Required - Your desired agent symbol (3-14 characters).
- **faction** (string) - Required - The symbol of the faction (COSMIC, VOID, GALACTIC, QUANTUM, DOMINION).

### Request Example
{
  "symbol": "BADGER",
  "faction": "COSMIC"
}

### Response
#### Success Response (201)
- Successfully registered.
```

--------------------------------

### Mount Installation Bug Fix

Source: https://docs.spacetraders.io/resources/changelog

Fixed bug allowing installation of one more mount than specs allow.

```text
2b7ead08
```

--------------------------------

### Refuel Ship

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command refuels your ship at the current waypoint.

```bash
curl --request POST \
  --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/refuel'
```

--------------------------------

### Example Rate Limit Exceeded Response

Source: https://docs.spacetraders.io/api-guide/rate-limits

An example of an HTTP response when the API rate limit has been exceeded, including relevant headers and a JSON body detailing the error.

```http
HTTP/1.1 429 Too Many Requests
Date: Tue, 21 Jan 2023 23:36:32 GMT
access-control-allow-origin: *
access-control-expose-headers: Retry-After, X-RateLimit-Type, X-RateLimit-Limit-Burst, X-RateLimit-Limit-Per-Second, X-RateLimit-Remaining, X-RateLimit-Reset
content-type: application/json; charset=utf-8
retry-after: 1
x-powered-by: Express
x-ratelimit-limit-burst: 10
x-ratelimit-limit-per-second: 2
x-ratelimit-remaining: 0
x-ratelimit-reset: 2023-01-21T23:36:33.435Z
x-ratelimit-type: IP Address

{
  "error": {
    "message": "You have reached your API limit.",
    "code": 429,
    "data": {
      "type": "IP Address",
      "retryAfter": 1,
      "limitBurst": 10,
      "limitPerSecond": 2,
      "remaining": 0,
      "reset": "2023-01-21T23:36:33.435Z"
    }
  }
}


```

--------------------------------

### Register New Agent

Source: https://docs.spacetraders.io/openapi

Create a new agent by providing a unique symbol and selecting a starting faction.

```bash
curl https://api.spacetraders.io/v2/register \
  --request POST \
  --header 'Content-Type: application/json' \
  --data '{
  "symbol": "BADGER",
  "faction": "COSMIC"
}'
```

--------------------------------

### Orbit Ship

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command puts your ship in orbit around a waypoint.

```bash
curl --request POST \
  --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/orbit'
```

--------------------------------

### Negotiate a New Contract

Source: https://docs.spacetraders.io/quickstart/first-mission

This cURL command demonstrates how to request a new contract through the 'negotiate/contract' endpoint, useful if a previous contract has expired.

```shell
curl --request POST \
 --url 'https://api.spacetraders.io/v2/my/ships/:shipSymbol/negotiate/contract' \
 --header 'Authorization: Bearer AGENT_TOKEN'
```

--------------------------------

### GET /agents

Source: https://docs.spacetraders.io/openapi

Retrieve a list of agents.

```APIDOC
## GET /agents

### Description
Retrieve a list of agents.

### Method
GET

### Endpoint
/agents
```

--------------------------------

### Authenticating with the API

Source: https://docs.spacetraders.io/api-guide/authorization

Example of how to authenticate with the SpaceTraders API using a JWT bearer token in the Authorization header.

```curl
curl 'https://api.spacetraders.io/v2/my/agent'
```

--------------------------------

### GET /factions

Source: https://docs.spacetraders.io/openapi

Retrieves a list of all factions in the game.

```APIDOC
## GET /factions

### Description
List all factions available in the game.

### Method
GET

### Endpoint
https://api.spacetraders.io/v2/factions

### Parameters
#### Query Parameters
- **page** (integer) - Optional - Page number of the results.
- **limit** (integer) - Optional - Number of results per page.
```

--------------------------------

### View Contracts

Source: https://docs.spacetraders.io/quickstart/first-mission

This cURL command shows how to view your current contracts if you don't have the contract ID.

```shell
curl 'https://api.spacetraders.io/v2/my/contracts' \
 --header 'Authorization: Bearer AGENT_TOKEN'
```

--------------------------------

### Register as a new agent by API

Source: https://docs.spacetraders.io/quickstart/new-game

This cURL command registers a new agent programmatically. Replace ACCOUNT_TOKEN with your actual account token and INSERT_CALLSIGN_HERE with your desired agent call sign.

```curl
curl --request POST \ 
 --url 'https://api.spacetraders.io/v2/register' \ 
 --header 'Authorization: Bearer ACCOUNT_TOKEN' \ 
 --header 'Content-Type: application/json' \ 
 --data '{  
    "symbol": "INSERT_CALLSIGN_HERE",  
    "faction": "COSMIC"  
   }'
```

--------------------------------

### Account Response Schema

Source: https://docs.spacetraders.io/openapi

Example JSON response structure returned when fetching account details.

```json
{
  "data": {
    "account": {
      "id": "string",
      "email": null,
      "token": "string",
      "createdAt": "2026-08-15T18:46:24.623Z"
    }
  }
}
```

--------------------------------

### Navigate to delivery waypoint

Source: https://docs.spacetraders.io/quickstart/last-steps

Send a POST request to the `my/ships/:shipSymbol/navigate` endpoint to navigate your ship to a waypoint.

```curl
curl --request POST \ 
 --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/navigate' \ 
 --header 'Content-Type: application/json' \ 
 --data '{  
    "waypointSymbol": ""  
   }'
```

--------------------------------

### Example API Response

Source: https://docs.spacetraders.io/

An example of a successful API response for a trade operation.

```json
HTTP/1.1 200 OK


{
  "shipSymbol": "SP4CE-TR4DER-1",
  "tradeSymbol": "QUANTUM_DRIVES",
  "type": "SELL",
  "units": 15,
  "pricePerUnit": 9600,
  "totalPrice": 144000,
  "timestamp": "2022-12-23T18:14:49.053Z"
}
```

--------------------------------

### GET /my/ships

Source: https://docs.spacetraders.io/openapi

Retrieve a list of the current agent's ships.

```APIDOC
## GET /my/ships

### Description
Retrieve a list of the current agent's ships.

### Method
GET

### Endpoint
/my/ships
```

--------------------------------

### GET /my/account

Source: https://docs.spacetraders.io/openapi

Fetch the details of your current SpaceTraders account.

```APIDOC
## GET /my/account

### Description
Fetch your account details.

### Method
GET

### Endpoint
https://api.spacetraders.io/v2/my/account

### Response
#### Success Response (200)
- **data** (object) - The account data object.

#### Response Example
{
  "data": {
    "account": {
      "id": "string",
      "email": null,
      "token": "string",
      "createdAt": "2026-08-15T18:46:24.623Z"
    }
  }
}
```

--------------------------------

### Update: Ship Mounts

Source: https://docs.spacetraders.io/resources/changelog

Ability to install and remove ship mounts has been added.

```text
Added ability to install and remove ship mounts (05d1248c)
```

--------------------------------

### Mount Symbol Validation

Source: https://docs.spacetraders.io/resources/changelog

Validated mount symbol on install.

```text
7afd2537
```

--------------------------------

### GET /my/contracts

Source: https://docs.spacetraders.io/openapi

Retrieve a list of the current agent's contracts.

```APIDOC
## GET /my/contracts

### Description
Retrieve a list of the current agent's contracts.

### Method
GET

### Endpoint
/my/contracts
```

--------------------------------

### GET /systems/{systemSymbol}/waypoints/{waypointSymbol}

Source: https://docs.spacetraders.io/openapi

Retrieves details for a specific waypoint.

```APIDOC
## GET /systems/{systemSymbol}/waypoints/{waypointSymbol}

### Description
Get the details of a specific waypoint.

### Method
GET

### Endpoint
https://api.spacetraders.io/v2/systems/{systemSymbol}/waypoints/{waypointSymbol}

### Parameters
#### Path Parameters
- **systemSymbol** (string) - Required - The symbol of the system.
- **waypointSymbol** (string) - Required - The symbol of the waypoint.
```

--------------------------------

### Jettison Non-Contract Cargo

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command jettisons specified cargo units from your ship.

```bash
curl --request POST \
  --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/jettison' \
  --header 'Content-Type: application/json' \
  --data '{ \
    "symbol": "", \
    "units": "" \
   }'
```

--------------------------------

### Dock your ship

Source: https://docs.spacetraders.io/quickstart/sell-cargo

Send a POST request to the dock endpoint to dock your ship at a marketplace.

```curl
curl --request POST \
 --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/dock'
```

--------------------------------

### GET /systems/{systemSymbol}/waypoints

Source: https://docs.spacetraders.io/openapi

Retrieves all waypoints within a specific system.

```APIDOC
## GET /systems/{systemSymbol}/waypoints

### Description
List all waypoints in a given system.

### Method
GET

### Endpoint
https://api.spacetraders.io/v2/systems/{systemSymbol}/waypoints

### Parameters
#### Path Parameters
- **systemSymbol** (string) - Required - The symbol of the system.
```

--------------------------------

### Fulfill contract

Source: https://docs.spacetraders.io/quickstart/last-steps

Send a POST request to the `my/contracts/:contractId/fulfill` endpoint to receive full payment once contract terms are met.

```curl
curl --request POST \ 
 --url 'https://api.spacetraders.io/v2/my/contracts/:contractId/fulfill'
```

--------------------------------

### Find Nearby Engineered Asteroid

Source: https://docs.spacetraders.io/quickstart/mine-asteroids

This cURL command finds an engineered asteroid in the current system.

```bash
curl 'https://api.spacetraders.io/v2/systems/:systemSymbol/waypoints?type=ENGINEERED_ASTEROID'
```

--------------------------------

### Deliver contract goods

Source: https://docs.spacetraders.io/quickstart/last-steps

Send a POST request to the `my/contracts/:contractId/deliver` endpoint to deliver goods. This request will only succeed if your ship is at the delivery waypoint, and your cargo hold contains the required goods.

```curl
curl --request POST \ 
 --url 'https://api.spacetraders.io/v2/my/contracts/:contractId/deliver' \ 
 --header 'Content-Type: application/json' \ 
 --data '{  
    "shipSymbol": "",  
    "tradeSymbol": "",  
    "units": ""  
   }'
```

--------------------------------

### Check Game Server Status

Source: https://docs.spacetraders.io/openapi

Perform a GET request to the base API URL to verify the game server is reachable.

```json
{
  "method": "GET",
  "url": "https://api.spacetraders.io/v2",
}
```

--------------------------------

### Find a shipyard

Source: https://docs.spacetraders.io/quickstart/purchase-ship

This cURL command finds all waypoints in the current system that have the SHIPYARD trait.

```curl
curl 'https://api.spacetraders.io/v2/systems/:systemSymbol/waypoints?traits=SHIPYARD'
```

--------------------------------

### Purchase a ship

Source: https://docs.spacetraders.io/quickstart/purchase-ship

This cURL command purchases a new ship by sending a POST request to the my/ships endpoint, specifying the ship type and waypoint.

```curl
curl --request POST \
 --url 'https://api.spacetraders.io/v2/my/ships' \
 --header 'Content-Type: application/json' \
 --data '{ \
    "shipType": "SHIP_MINING_DRONE", \
    "waypointSymbol": "" \
   }'
```

--------------------------------

### Ship Module Endpoints

Source: https://docs.spacetraders.io/resources/changelog

Endpoints for managing ship modules, including installation and removal.

```http
GET /my/ships/{shipSymbol}/modules
POST /my/ships/{shipSymbol}/modules/install
POST /my/ships/{shipSymbol}/modules/remove
```

--------------------------------

### View available ships

Source: https://docs.spacetraders.io/quickstart/purchase-ship

This cURL command retrieves the ships available for purchase at a specific shipyard waypoint.

```curl
curl 'https://api.spacetraders.io/v2/systems/:systemSymbol/waypoints/:shipyardWaypointSymbol/shipyard'
```

--------------------------------

### Faction Error Codes

Source: https://docs.spacetraders.io/api-guide/response-errors

Examples of error codes related to faction interactions.

```javascript
const waypointNoFactionError = 4700
```

--------------------------------

### Update: Trade and Economy

Source: https://docs.spacetraders.io/resources/changelog

Updates to trade prices, fuel costs, and removal of certain items from starting systems.

```text
Updated trade and economy: rebalanced trade prices, tweaked price of fuel, removed antimatter from starting systems and homeworld exports (fbcf99da, 1ed2f29c, e95caf99)
```

--------------------------------

### General Error Codes

Source: https://docs.spacetraders.io/api-guide/response-errors

Examples of general error codes used in the API.

```javascript
const cooldownConflictError = 4000
const waypointNoAccessError = 4001
```

--------------------------------

### Get Market Information

Source: https://docs.spacetraders.io/game-concepts/markets

This cURL command retrieves market data for a specific waypoint within a system.

```curl
curl --request  \
 --url 'https://api.spacetraders.io/v2/systems/:systemSymbol/waypoints/:waypointSymbol/market'
```

--------------------------------

### Sell goods

Source: https://docs.spacetraders.io/quickstart/sell-cargo

Send a POST request to the sell endpoint to sell cargo at a marketplace, specifying the good symbol and units.

```curl
curl --request POST \
 --url 'https://api.spacetraders.io/v2/my/ships/:miningShipSymbol/sell' \
 --header 'Content-Type: application/json' \
 --data '{ \
    "symbol": "IRON_ORE", \
    "units": "100" \
   }'
```

--------------------------------

### Register a New Agent

Source: https://docs.spacetraders.io/game-concepts/agents-and-factions

This cURL request registers a new agent, requiring a unique call sign and a starting faction. It includes an ACCOUNT_TOKEN for authorization and specifies the request body in JSON format.

```curl
curl --request POST \ 
 --url 'https://api.spacetraders.io/v2/register' \ 
 --header 'Authorization: Bearer ACCOUNT_TOKEN' \ 
 --header 'Content-Type: application/json' \ 
 --data '{  
    "symbol": "",  
    "faction": ""  
   }'
```

--------------------------------

### Update: Starter System Parameters

Source: https://docs.spacetraders.io/resources/changelog

Changes to starter system parameters.

```text
Changed starter system parameters (b82e5695)
```

--------------------------------

### POST /register

Source: https://docs.spacetraders.io/openapi

Registers a new agent to the game.

```APIDOC
## POST /register

### Description
Registers a new agent to the game.

### Method
POST

### Endpoint
/register

### Response
#### Success Response (201)
- **data** (object) - The registration data containing the token, agent details, faction, contract, and ships.

#### Response Example
{
  "data": {
    "token": "string",
    "agent": {
      "accountId": "string",
      "symbol": "string",
      "headquarters": "string",
      "credits": 1,
      "startingFaction": "string",
      "shipCount": 1
    },
    "faction": {
      "symbol": "COSMIC",
      "name": "string",
      "description": "string",
      "headquarters": "string",
      "traits": [
        {
          "symbol": "BUREAUCRATIC",
          "name": "string",
          "description": "string"
        }
      ],
      "isRecruiting": true
    },
    "contract": {
      "id": "string",
      "factionSymbol": "string",
      "type": "PROCUREMENT",
      "terms": {
        "deadline": "2026-08-15T18:46:24.623Z",
        "payment": {
          "onAccepted": 1,
          "onFulfilled": 1
        },
        "deliver": [
          {
            "tradeSymbol": "string",
            "destinationSymbol": "string",
            "unitsRequired": 1,
            "unitsFulfilled": 1
          }
        ]
      },
      "accepted": false,
      "fulfilled": false,
      "deadlineToAccept": "2026-08-15T18:46:24.623Z"
    },
    "ships": []
  }
}
```

--------------------------------

### Fetch Account Details

Source: https://docs.spacetraders.io/openapi

Retrieve account information using a bearer token for authentication.

```bash
curl https://api.spacetraders.io/v2/my/account \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
```

--------------------------------

### POST /my/ships/{shipSymbol}/dock

Source: https://docs.spacetraders.io/openapi

Dock a ship at the current waypoint.

```APIDOC
## POST /my/ships/{shipSymbol}/dock

### Description
Dock a ship at the current waypoint.

### Method
POST

### Endpoint
/my/ships/{shipSymbol}/dock

### Parameters
#### Path Parameters
- **shipSymbol** (string) - Required - The symbol of the ship to dock.
```

--------------------------------

### Transaction Object Correction

Source: https://docs.spacetraders.io/resources/changelog

Corrected the transaction object in the install / remove 201 response.

```text
5ae4f737
```

--------------------------------

### POST /my/contracts/{contractId}/accept

Source: https://docs.spacetraders.io/openapi

Accept a specific contract.

```APIDOC
## POST /my/contracts/{contractId}/accept

### Description
Accept a specific contract.

### Method
POST

### Endpoint
/my/contracts/{contractId}/accept

### Parameters
#### Path Parameters
- **contractId** (string) - Required - The ID of the contract to accept.
```

--------------------------------

### Market Error Codes

Source: https://docs.spacetraders.io/api-guide/response-errors

Examples of error codes related to market transactions.

```javascript
const marketTradeInsufficientCreditsError = 4600
const marketTradeNoPurchaseError = 4601
const marketTradeNotSoldError = 4602
const marketNotFoundError = 4603
const marketTradeUnitLimitError = 4604
```

--------------------------------

### Contract Error Codes

Source: https://docs.spacetraders.io/api-guide/response-errors

Examples of error codes related to contract management.

```javascript
const acceptContractNotAuthorizedError = 4500
const acceptContractConflictError = 4501
const fulfillContractDeliveryError = 4502
const contractDeadlineError = 4503
const contractFulfilledError = 4504
const contractNotAcceptedError = 4505
const contractNotAuthorizedError = 4506
const shipDeliverTermsError = 4508
const shipDeliverFulfilledError = 4509
const shipDeliverInvalidLocationError = 4510
const existingContractError = 4511
```

--------------------------------

### Ship Error Codes

Source: https://docs.spacetraders.io/api-guide/response-errors

Examples of error codes related to ship operations.

```javascript
const navigateInTransitError = 4200
const navigateInvalidDestinationError = 4201
const navigateOutsideSystemError = 4202
const navigateInsufficientFuelError = 4203
const navigateSameDestinationError = 4204
const shipExtractInvalidWaypointError = 4205
const shipExtractPermissionError = 4206
const shipJumpNoSystemError = 4207
const shipJumpSameSystemError = 4208
const shipJumpMissingModuleError = 4210
const shipJumpNoValidWaypointError = 4211
const shipJumpMissingAntimatterError = 4212
const shipInTransitError = 4214
const shipMissingSensorArraysError = 4215
const purchaseShipCreditsError = 4216
const shipCargoExceedsLimitError = 4217
const shipCargoMissingError = 4218
const shipCargoUnitCountError = 4219
const shipSurveyVerificationError = 4220
const shipSurveyExpirationError = 4221
const shipSurveyWaypointTypeError = 4222
const shipSurveyOrbitError = 4223
const shipSurveyExhaustedError = 4224
const shipRefuelDockedError = 4225
const shipRefuelInvalidWaypointError = 4226
const shipMissingMountsError = 4227
const shipCargoFullError = 4228
const shipJumpFromGateToGateError = 4229
const waypointChartedError = 4230
const shipTransferShipNotFound = 4231
const shipTransferAgentConflict = 4232
const shipTransferSameShipConflict = 4233
const shipTransferLocationConflict = 4234
const warpInsideSystemError = 4235
const shipNotInOrbitError = 4236
const shipInvalidRefineryGoodError = 4237
const shipInvalidRefineryTypeError = 4238
const shipMissingRefineryError = 4239
const shipMissingSurveyorError = 4240
const shipMissingWarpDriveError = 4241
const shipMissingMineralProcessorError = 4242
const shipMissingMiningLasersError = 4243
const shipNotDockedError = 4244
const purchaseShipNotPresentError = 4245
const shipMountNoShipyardError = 4246
const shipMissingMountError = 4247
const shipMountInsufficientCreditsError = 4248
const shipMissingPowerError = 4249
const shipMissingSlotsError = 4250
const shipMissingMountsError = 4251
const shipMissingCrewError = 4252
const shipExtractDestabilizedError = 4253
const shipJumpInvalidOriginError = 4254
const shipJumpInvalidWaypointError = 4255
const shipJumpOriginUnderConstructionError = 4256
const shipMissingGasProcessorError = 4257
const shipMissingGasSiphonsError = 4258
const shipSiphonInvalidWaypointError = 4259
const shipSiphonPermissionError = 4260
const waypointNoYieldError = 4261
const shipJumpDestinationUnderConstructionError = 4262
```

--------------------------------

### Account Error Codes

Source: https://docs.spacetraders.io/api-guide/response-errors

Examples of error codes related to account management.

```javascript
const tokenEmptyError = 4100
const tokenMissingSubjectError = 4101
const tokenInvalidSubjectError = 4102
const missingTokenRequestError = 4103
const invalidTokenRequestError = 4104
const invalidTokenSubjectError = 4105
const accountNotExistsError = 4106
const agentNotExistsError = 4107
const accountHasNoAgentError = 4108
const registerAgentExistsError = 4109
const registerAgentSymbolReservedError = 4110
const registerAgentConflictSymbolError = 4111
```

--------------------------------

### Economy Rebalance

Source: https://docs.spacetraders.io/resources/changelog

Rebalanced economy: exchange purchase/sell prices are more aligned, margins are a bit lower across the universe, starter system exchanges now support higher volumes in common ores and minerals, and have lower trade volume for diamonds.

```text
729b29f5, def78e67
```

--------------------------------

### List All Systems

Source: https://docs.spacetraders.io/game-concepts/systems-waypoints

Endpoint to retrieve a list of all systems in the SpaceTraders universe.

```cURL
curl --request  \
 --url 'https://api.spacetraders.io/v2/systems'
```

--------------------------------

### Gas Extraction and Fuel Refinement Preparation

Source: https://docs.spacetraders.io/resources/changelog

Preparing to add gas extraction and fuel refinement.

```text
bb274b58
```

--------------------------------

### Supply Construction Materials

Source: https://docs.spacetraders.io/resources/changelog

Use the new endpoint to supply materials to waypoints under construction.

```bash
POST /construction/supply
```

--------------------------------

### POST /systems/{systemSymbol}/waypoints/{waypointSymbol}/construction/supply

Source: https://docs.spacetraders.io/openapi

Supplies resources to a construction site at a waypoint.

```APIDOC
## POST /systems/{systemSymbol}/waypoints/{waypointSymbol}/construction/supply

### Description
Supply resources to a construction site.

### Method
POST

### Endpoint
https://api.spacetraders.io/v2/systems/{systemSymbol}/waypoints/{waypointSymbol}/construction/supply

### Parameters
#### Path Parameters
- **systemSymbol** (string) - Required - The symbol of the system.
- **waypointSymbol** (string) - Required - The symbol of the waypoint.
```

--------------------------------

### Siphon Hydrocarbons from Gas Giants

Source: https://docs.spacetraders.io/resources/changelog

Use the new siphon endpoint to siphon gases from a gas giant.

```bash
POST /my/ships/{shipSymbol}/siphon
```

--------------------------------

### Extraction Server Error Fix

Source: https://docs.spacetraders.io/resources/changelog

Resolved a server error on extraction.

```text
bb56cf52
```

--------------------------------

### API Error Response Structure

Source: https://docs.spacetraders.io/api-guide/response-errors

An example of the JSON structure for an API error response, including message, code, and data fields.

```json
{
  "error": {
    "message": "Missing Bearer token in the request. Did you confirm sending the \"Bearer {token}\" as the authorization header?",
    "code": 4103,
    "data": {}
  }
}
```

--------------------------------

### Update: New Agent Experience

Source: https://docs.spacetraders.io/resources/changelog

Enhancements to the new agent experience, including easier contracts and increased payments.

```text
Enhanced new agent experience: easier new agent contracts, increased new agent contract payment, new agent probe ship at shipyard (13f7629f, 14695b27, 64a9b892)
```

--------------------------------

### Universe Seeding Improvement

Source: https://docs.spacetraders.io/resources/changelog

Improved universe seeding: starter waypoints are now closer together, and starter systems are seeded with closer waypoints for fuel.

```text
ad4c2f0b, 2bc6e377
```
Tokens:
Raw