Wird geladen…
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.
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));| 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=&freightonly=&autoloadonly=&autoload= | Profit-Routen-Rechner mit Rückroute & Anschlussfracht. Jede Route trägt from/toFreightElevator (physischer Fracht-Aufzug, Handladen) UND from/toAutoLoad (ATC-Auto-Load am Cargo-Deck — nicht dasselbe: ein Boden-Outpost hat oft einen Aufzug, aber kein Auto-Load). freightonly=1 = nur Routen mit Aufzug an beiden Terminals; autoloadonly=1 = nur Routen mit Auto-Load an beiden Terminals; autoload=1 lockert die gemeldete Nachfrage. Jede Route trägt zudem distanceGm (In-System-Luftlinie in Gigametern) + crossSystem (Sprung nötig). |
| GET/trade/best-buyer?commodity=&qty= | Bester Abnehmer für eine Ware & Menge |
| GET/trade/terminals-list | Liste aller Handels-Terminals inkl. freightElevator (physischer Fracht-Aufzug), autoLoad (ATC-Auto-Load am Cargo-Deck), loadingDock, cargoCenter und maxContainerSize |
| GET/trade/cargo-ships | Liste der Cargo-Schiffe |
| GET/trade/systems | Systeme mit Handelsdaten |
| 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 |
| Endpoint | Beschreibung |
|---|---|
| GET/blueprints?q=&type= | Blueprint-Suche mit Filtern |
| GET/blueprints/types | Liste der Blueprint-Typen |
| GET/blueprints/:uuid | Blueprint-Detail |
| Endpoint | Beschreibung |
|---|---|
| GET/mining/ores | Erz-Datenbank (Name, Slug, Roh-/Refined-Verkaufspreis, Refine-Uplift)Beispiel-Response ▾[
{
"name": "Iron",
"slug": "iron",
"tier": "common",
"rarity": "Häufig",
"rawSell": 1000, // aUEC/SCU roh (falls verkaufbar)
"refinedSell": 3600, // aUEC/SCU raffiniert
"refineUplift": 260 // % Mehrwert durch Raffinieren
}
] |
| GET/mining/ores/:slug | Erz-Detail: Physik, Quality, Vorkommen |
| GET/mining/board | Mining-Board: je Erz Roh- & Refined-Bestpreis + TerminalBeispiel-Response ▾[
{
"oreId": 45,
"ore": "Iron (Ore)",
"rawSell": null, // Roherz meist nicht verkaufbar
"rawTerminal": null,
"refinedName": "Iron",
"refinedSell": 3600, // aUEC/SCU
"refinedTerminal": "TDD - Area18",
"refinedSystem": "Stanton"
}
] |
| GET/mining/methods | Raffinerie-Verfahren mit Yield/Kosten/Speed-Rating (1=niedrig … 3=hoch)Beispiel-Response ▾[
{
"uexId": 2,
"name": "Dinyx Solventation",
"code": "DIN",
"ratingYield": 3, // Ausbeute (höher = mehr Material)
"ratingCost": 1, // Kosten (niedriger = günstiger)
"ratingSpeed": 1 // Tempo (höher = schneller)
}
] |
| GET/mining/yields/:id | Yield-Modifikator je Refinery-Standort für ein Erz (:id = commodityId, z.B. 45 = Iron)Beispiel-Response ▾// GET /mining/yields/45
[
{
"terminalName": "Refinement Center - Levski",
"system": "Stanton",
"value": 8.00 // Yield-Modifikator in % (+ = besser, − = schlechter)
},
{
"terminalName": "Refinement Processing - CRU-L1",
"system": "Stanton",
"value": 2.00
}
] |
| 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 |
| 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 |
| Endpoint | Beschreibung |
|---|---|
| GET/items?q=&type=&category=&page=&pageSize= | Item-/Komponenten-Suche mit Filtern, serverseitig paginiert (Default 50/Seite, max. 100). Antwort: { items, total, page, pageSize } — nicht mehr eine nackte Liste. category ist eine grobe Gruppe (weapons/weapon_mods/armor/clothing/ship_components/consumables/misc), type der genaue scunpacked-Typ. |
| 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 |
| Endpoint | Beschreibung |
|---|---|
| GET/health | Status + letzte Sync-Zeiten |
| GET/stats | Globale Statistiken |
| GET/manufacturers | Liste aller Hersteller |
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.