CitizenHQ API.
Eine kostenlose, öffentliche, read-only API für Star-Citizen-Daten — Handel/Börse, Schiffe, Blueprints, Mining, Missionen und Orte. Dieselben Daten, die auch CitizenHQ antreiben.
Quickstart
https://citizenhq.space/api/v1
curl https://citizenhq.space/api/v1/trade/market
fetch("https://citizenhq.space/api/v1/trade/market")
.then((res) => res.json())
.then((data) => console.log(data));Endpunkt-Referenz
Handel / Börse
| Endpoint | Beschreibung |
|---|---|
| GET/trade/market | Live-Markt-Board: Preis, 1h/24h-Änderung, Sparkline, Volumen je Ware |
| GET/trade/overview | Handels-Übersicht |
| GET/trade/board | Handels-Board |
| GET/trade/commodity-list | Liste aller handelbaren Waren |
| GET/trade/commodity/:id | Waren-Detail inkl. Preise je Terminal |
| GET/trade/history?commodity=&terminal= | Preisverlauf einer Ware an einem Terminal |
| GET/trade/chart?commodity= | Chart-Daten für eine Ware |
| GET/trade/movers | Gewinner & Verlierer — größte Preisbewegungen |
| GET/trade/routes | Top-Handelsrouten |
| GET/trade/trader-routes?cargo=&budget=&origin=&dest=&originTerminal=&destTerminal=&sort=&roundtrip=&onward= | Profit-Routen-Rechner mit Rückroute & Anschlussfracht |
| GET/trade/best-buyer?commodity=&qty= | Bester Abnehmer für eine Ware & Menge |
| GET/trade/terminals-list | Liste aller Handels-Terminals |
| GET/trade/cargo-ships | Liste der Cargo-Schiffe |
| GET/trade/systems | Systeme mit Handelsdaten |
Schiffe
| Endpoint | Beschreibung |
|---|---|
| GET/ships?q=&manufacturer=&role=&size= | Schiffs-Suche mit Filtern |
| GET/ships/manufacturers | Liste der Hersteller |
| GET/ships/roles | Liste der Schiffsrollen |
| GET/ships/:slug | Schiffs-Detail inkl. Kauf-/Miet-Terminals |
Blueprints
| Endpoint | Beschreibung |
|---|---|
| GET/blueprints?q=&type= | Blueprint-Suche mit Filtern |
| GET/blueprints/types | Liste der Blueprint-Typen |
| GET/blueprints/:uuid | Blueprint-Detail |
Mining
| Endpoint | Beschreibung |
|---|---|
| GET/mining/ores | Erz-Datenbank |
| GET/mining/ores/:slug | Erz-Detail: Physik, Quality, Vorkommen |
| GET/mining/board | Mining-Board |
| GET/mining/methods | Raffinerie-Methoden |
| GET/mining/yields/:id | Ertrags-Daten für ein Erz |
Missionen
| Endpoint | Beschreibung |
|---|---|
| GET/missions?... | Missions-Suche mit Filtern |
| GET/missions/filters | Verfügbare Filter-Werte |
| GET/missions/:uuid | Missions-Detail |
| GET/missions/:uuid/chain | Missions-Kette der Mission |
| GET/chains | Liste aller Missions-Ketten |
Orte
| Endpoint | Beschreibung |
|---|---|
| GET/locations | Orte / Stationen |
| GET/locations/systems | Systeme mit Orten |
| GET/stations | Liste der Stationen |
| GET/stations/detail | Stations-Detail |
| GET/systems | Liste der Sternsysteme |
| GET/systems/:id | System-Detail |
| GET/fuel-prices | Treibstoff-Preise je Terminal |
Items
| Endpoint | Beschreibung |
|---|---|
| GET/items?q=&type= | Item-/Komponenten-Suche mit Filtern |
| GET/items/types | Liste der Item-Typen |
| GET/items/:uuid | Item-Detail |
| GET/item-shops | Liste der Item-Shops |
| GET/item-shops/:id | Item-Shop-Detail |
Meta
| Endpoint | Beschreibung |
|---|---|
| GET/health | Status + letzte Sync-Zeiten |
| GET/stats | Globale Statistiken |
| GET/manufacturers | Liste aller Hersteller |
Nutzungsbedingungen & Attribution
Die API ist read-only (nur GET) und unterliegt einem Fair-Use-Limit von 60 Anfragen pro Minute pro IP-Adresse (Burst 30). Bei Überschreitung antwortet die API mit HTTP 429.
Wenn du Daten aus der API anzeigst oder weiterverarbeitest, gib bitte die Quelle an: „Daten via UEX Corp, scunpacked & Star Citizen Wiki". Antworten tragen dazu einen X-Data-Source-Header.
Alle Daten werden „as is" bereitgestellt — Live-Werte im Spiel können von den hier gelieferten Daten abweichen. Es besteht keine Verbindung zu Cloud Imperium Games oder Roberts Space Industries. Star Citizen® ist eine Marke von CIG.
▢ Fragen oder Feedback zur API? Sag's uns auf Discord.