The API documentation for the SpaceTraders API
Go to file
2023-12-10 13:48:19 -08:00
.github/workflows Add a github action that generates a couple of clients using openapi generator (#60) 2023-06-23 21:35:42 -07:00
docs update: switch to /v2 url path 2023-04-13 13:23:34 -07:00
models Agent.shipCount always seems to be returned. Why would this be optional? 2023-12-10 13:48:19 -08:00
reference Remove $ref suiblings. 2023-12-05 14:00:24 -08:00
.gitignore Add styleguide to ignore 2023-05-23 08:35:12 -06:00
.spectral.mjs Create .spectral.mjs 2022-12-30 16:16:28 -07:00
.stoplight.json Modified 2 files 2022-03-14 17:35:39 -07:00
README.md Update README.md 2023-09-23 12:10:04 -07:00
redocly.yaml feat: update ship schema 2022-10-05 18:13:47 -07:00

Getting Started

SpaceTraders is an API-based game where you acquire and manage a fleet of ships to explore, trade, and fight your way across the galaxy.

Use the links below to get started with SpaceTraders.

  • Main Website - Learn more about the game and the team behind it.
  • Documentation - Read the full documentation for the SpaceTraders API.
  • Quickstart - Try out the SpaceTraders API directly in your browser.
  • Game concepts - Learn about core game mechanics such as fleets, factions and systems.
  • API guide - Learn the fundamentals of working with the SpaceTraders API.

Overview

SpaceTraders is an open-universe game and learning platform that offers a set of HTTP endpoints to control a fleet of ships and explore a multiplayer universe.

The API is documented using OpenAPI and Stoplight Studio. You can send requests directly from Stoplight Studio or use the interactive documentation to try out the API.

Unlike a traditional game, SpaceTraders does not have a first-party client or app to play the game. Instead, you can use the API to build your own client, write a script to automate your ships, or try an app built by the community.

We have a Discord channel where you can share your projects, ask questions, and get help from other players.

Gameplay

The goal of the game is to manage a fleet of ships as you explore the universe and try to turn a profit. You can trade goods across systems, mine asteroids for valuable ores, or take on faction contracts to earn credits and reputation.

All players operate in the same universe, so you can compete with others to earn the most credits or chart the most systems. The game is currently in alpha, and we plan to add player-vs-player combat, bounty hunting, and more.

Roadmap

We plan to work toward the following features and capabilities. If you have any feedback or suggestions, please share them in our Discord channel.

  • scavenge derelict ships for valuable cargo and spare parts
  • create webhooks to receive notifications when events occur in the game
  • search for ancient artifacts on distant planets to sell for profit
  • send envoys to meet new factions and generate contracts or unique trade deals
  • private game worlds deployed on a separate server for testing or playing with friends
  • take on bounties to earn credits or pirate other players trade routes
  • a GraphQL API for querying systems and waypoints
  • deploy envoys to track rumors and generate contracts

Next steps

The SpaceTraders API is an excellent platform to learn a new programming language, test a new framework, or stretch your skills in a fun and meaningful way.

If you are new to SpaceTraders, you should try our interactive quickstart guide which will walk you through basic API requests in just a few minutes.

If you're looking for some project inspiration, here are some ideas to get you started:

  • create a script to mine asteroids and automate trade routes
  • build a web or mobile app to manage your fleet of ships
  • track and share market price data with other players
  • generate an SDK from the OpenAPI spec and publish it
  • create a Discord bot for others players to use

And finally, if you find an issue and want to report it, please open an issue on our GitHub repository or share it in our Discord channel.

Donating

By supporting us, youre not just helping keep the servers running, but potentially helping thousands of fellow developers learn and exercise their programming skills. Were grateful for your support, and together, were excited to see the full potential of the API! Thank you for being a part of this journey.

Additionally:

  • We will make sure that we reserve your callsign between alpha/beta resets
  • Vote for your most desired features
  • Custom Role in Discord

Donate with Stripe Link