### 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'
```

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

### 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'
```

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

### 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": "" \
   }'
```

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

### Request Example for POST /register

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

Example of how to register a new agent using cURL.

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

```

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

### 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'
```

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

### 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"

```

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

### API Base URL Example

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

An example of how to make a GET request to the base URL of the SpaceTraders API to check the game server status.

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

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

### Get Account Response Example

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

Example JSON response for a successful GET request to the /my/account endpoint.

```json
{
  "data": {
    "account": {
      "id": "string",
      "email": null,
      "token": "string",
      "createdAt": "2026-05-27T22:35:58.258Z"
    }
  }
}
```

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

### 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 Account Request Example

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

Example of a cURL request to fetch account details using the /my/account endpoint.

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

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

### 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'
```

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

### 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'
```

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

### Mount Installation Bug Fix

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

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

```text
2b7ead08
```

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

### 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"
    }
  }
}


```

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

### 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'
```

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

### 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 New Agent

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

Example of registering a new agent.

```json
{
  "data": {
    "token": "string",
    "agent": {
      "accountId": "string",
      "symbol": "string",
      "secret": "string",
      "startingFaction": "string",
      "headquarters": "string",
      "ship": {
        "symbol": "string",
        "nav": {
          "system": "string",
          "waypoint": "string",
          "route": {
            "destination": {
              "system": "string",
              "waypoint": "string"
            },
            "departure": {
              "system": "string",
              "waypoint": "string"
            },
            "hoursToArrival": 0
          },
          "status": "NAV_STATUS_IN_TRANSIT",
          "speed": 1,
          "flightMode": "FLIGHT_MODE_CRUISE"
        },
        "crew": {
          "current": 1,
          "capacity": 1,
          "rotation": "CREW_ROTATION_STABLE",
          "morale": 1,
          "wages": 1
        },
        "frame": {
          "symbol": "FRAME_PROBE_I",
          "name": "string",
          "description": "string",
          "condition": 1,
          "moduleSlots": 1,
          "requirements": {
            "power": 1,
            "crew": 1,
            "slots": 1
          }
        },
        "reactor": {
          "symbol": "REACTOR_SOLAR_I",
          "name": "string",
          "description": "string",
          "condition": 1,
          "powerOutput": 1,
          "requirements": {
            "power": 1,
            "crew": 1,
            "slots": 1
          },
          "quality": 1
        },
        "engine": {
          "symbol": "ENGINE_IMPULSE_DRIVE_I",
          "name": "string",
          "condition": 1,
          "integrity": 1,
          "description": "string",
          "speed": 1,
          "requirements": {
            "power": 1,
            "crew": 1,
            "slots": 1
          },
          "quality": 1
        },
        "modules": [
          {
            "symbol": "MODULE_MINERAL_PROCESSOR_I",
            "name": "string",
            "description": "string",
            "capacity": 1,
            "range": 1,
            "requirements": {
              "power": 1,
              "crew": 1,
              "slots": 1
            }
          }
        ],
        "mounts": [
          {
            "symbol": "MOUNT_GAS_SIPHON_I",
            "name": "string",
            "description": "string",
            "strength": 1,
            "deposits": [
              "QUARTZ_SAND"
            ],
            "requirements": {
              "power": 1,
              "crew": 1,
              "slots": 1
            }
          }
        ],
        "cargo": {
          "capacity": 1,
          "units": 1,
          "inventory": [
            {
              "symbol": "PRECIOUS_STONES",
              "name": "string",
              "description": "string",
              "units": 1
            }
          ]
        },
        "fuel": {
          "current": 1,
          "capacity": 1,
          "consumed": {
            "amount": 1,
            "timestamp": "2026-05-27T22:35:58.258Z"
          }
        },
        "cooldown": {
          "shipSymbol": "string",
          "totalSeconds": 1,
          "remainingSeconds": 1,
          "expiration": "2026-05-27T22:35:58.258Z"
        }
      }
    }
  }
}
```

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

### 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'
```

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

### 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"  
   }'
```

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

### 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": ""  
   }'
```

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

### 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)
```

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

### 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"
}
```

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

### 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": "" \
   }'
```

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

### Mount Symbol Validation

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

Validated mount symbol on install.

```text
7afd2537
```

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

### 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'
```

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

### 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'
```

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

### Send Request

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

Example of sending a request to the API.

```curl
Send Request
^ 
↵Control Enter
```

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

### 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": ""  
   }'
```

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

### List Factions

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

Send a GET request to list factions.

```http
GET https://api.spacetraders.io/v2/factions
```

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

### 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'
```

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

### 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)
```

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

### 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" \
   }'
```

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

### Update: Starter System Parameters

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

Changes to starter system parameters.

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

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

### Transaction Object Correction

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

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

```text
5ae4f737
```

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

### Faction Error Codes

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

Examples of error codes related to faction interactions.

```javascript
const waypointNoFactionError = 4700
```

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

### 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
```

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

### 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
```

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

### 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
```

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

### 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
```

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

### 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
```

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

### 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
```

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

### 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'
```

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

### Extraction Server Error Fix

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

Resolved a server error on extraction.

```text
bb56cf52
```

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

### 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
```

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

### System Count Increase

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

Increased the system count to 12k.

```text
be5a3a72
```

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

### 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": {}
  }
}
```

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

### Diamond Profitability Update

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

Diamonds are now as profitable as gold or platinum.

```text
a78b9722
```

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

### Refueling from Cargo

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

Players can now refuel from cargo by setting `fromCargo: true` in their request.

```json
{
  "fromCargo": true
}
```

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

### Extract with Survey Endpoint

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

Migrate survey extractions to the new /my/ships/{shipSymbol}/extract/survey endpoint.

```bash
curl -X POST "https://api.spacetraders.io/v2/my/ships/{shipSymbol}/extract/survey" \
     -H "Authorization: Bearer YOUR_API_TOKEN" \
     -d '{ "survey": { "signature": "YOUR_SURVEY_SIGNATURE", "symbol": "YOUR_SURVEY_SYMBOL" } }'
```

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

### 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": ""  
   }'
```

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

### Credits Leaderboard Expansion

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

Increased the credits leaderboard to 15 spots.

```text
9ad38718
```

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

### Fix: Charting Waypoints

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

A bug with charting waypoints has been addressed.

```text
Addressed a bug with charting waypoints (d838011b)
```

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

### Fix: ShipInTransitError

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

Improved data in ShipInTransitError.

```text
Improved data in ShipInTransitError (303c17c7)
```

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

### List Waypoints in a System

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

Endpoint to retrieve a list of all waypoints within a specific system.

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