EDCN
Elite Dangerous Companion Network: the galaxy's current state, built from EDDN.
EDCN listens to EDDN, the network where players' tools share what they see in the game, and keeps the most recent data for each system, faction, station, market, module and ship for sale, fleet carrier bar, body (with its orbit and composition), barycentre, signal, codex discovery, and organic species: everything EDDN carries that is worth keeping. Messages from the Legacy game are left out. Nothing personal is kept.
Access
EDCN answers the applications it knows. Each one gets, once its request is accepted, an identifier and a fingerprint, to send with every call:
X-EDCN-App: <identifier> X-EDCN-Fingerprint: <fingerprint>
Keep them in your application; every copy sends the same. A call from an unknown application, with a wrong fingerprint, or from a blocked one gets an HTTP 401 or 403. Limit: 120 calls a minute from one address for one application; an HTTP 429 says to wait.
Answers are JSON. Times are UTC. An error answers {"error": "…"} with an HTTP status.
GET /api/v1/system?name=…
A system with its factions (most influent first) and its stations.
curl -H "X-EDCN-App: …" -H "X-EDCN-Fingerprint: …" "https://…/api/v1/system?name=Sol"
| Field | Content |
|---|---|
updated | When a jump last reported the system (absent when only seen in a scan or a route) |
factionsUpdated | When its factions were last reported |
factions[] | name, influence (percent), state, active / pending / recovering states, allegiance, government, happiness |
stations[] | marketId, name, type, distanceLs, pads, services, faction, economy, bodyName, latitude, longitude (settlements), updated, marketUpdated, outfittingUpdated, shipyardUpdated |
bodyCount | Bodies in the system, when a discovery scan reported it; allBodiesFound |
bodies[] | bodyId, name, starType or planetClass, landable, gravity (g), temperature (K), distanceLs, materials (percent), rings, signals (type, count), genuses, parents, orbit, composition, atmosphereType, atmosphereGases, pressure (Pa), luminosity, ageMy, absoluteMagnitude, scanUpdated, signalsUpdated |
signals[] | The system's signals: name, type, faction, threat, updated; tourist beacons and memorials also give the language of their name (en, fr, de, es, pt, ru), the one of the last player who reported them |
codex[] | Codex discoveries: name, category, bodyId, firstReported, lastReported |
organics[] | Species sampled on its bodies: bodyId, body, species, genus, variant, firstReported, lastReported |
barycentres[] | bodyId, orbit, updated |
GET /api/v1/offers?commodity=…
The stations trading a commodity, the best first.
curl -H "X-EDCN-App: …" -H "X-EDCN-Fingerprint: …" "https://…/api/v1/offers?commodity=tritium&near=Sol&range=100&sort=volume"
| Parameter | Meaning |
|---|---|
commodity | The game's name of the commodity (tritium, painite…). Required. |
mode | buy (default: stations selling it, with stock) or sell (stations buying it, with demand) |
near | A system's name: distances are counted from it (if EDCN knows the system) |
x, y, z | Or the reference's coordinates, in light years (what the game's journal gives) |
range | With a reference: the largest distance, in light years |
sort | volume (default: largest stock or demand), price, distance, recent |
limit | 1 to 500 (100 by default) |
Searches near a place
These searches take the same reference as offers: x, y, z or
near, then range and limit. With a reference the nearest come first, without
one the most recently reported. Each answers {"…": what was asked, "results": […]}.
| Call | Finds |
|---|---|
/api/v1/modules?module=a,b | Stations selling every listed module (the game's symbols: hpt_pulselaser_fixed_small) |
/api/v1/ships?ship=a,b | Stations selling every listed ship (anaconda, python_nx…) |
/api/v1/bodies?signal=… | Bodies with signals of a type: a ring's hotspot (Painite, LowTemperatureDiamond), or Biological, Geological |
/api/v1/signals?signal=… | System signals of a type (ResourceExtraction, Combat, Megaship…) or whose name holds the words (hazardous) |
/api/v1/codex?name=… | Codex discoveries whose name holds the words (Stratum) |
/api/v1/organics?name=… | Bodies where a species or variant was sampled (Bacterium, Tussock_Ignis) |
/api/v1/carrier-bars?material=… | Fleet carriers selling a material at their bar (mode=sell: buying it) |
GET /api/v1/faction?name=…
The systems where a minor faction is present, the most influent first: influence (percent), whether it controls the system, its states, its closest rival and that rival's influence, and when the system's factions were last reported.
GET /api/v1/station?marketId=…
A station with its market, modules, ships and, for a fleet carrier, its bar.
GET /api/v1/status
EDCN's own state: connection to EDDN, messages received and written, database size.
Ask for access
Tell what your application is: the request is read by EDCN's maintainer. Keep the code you get to see the answer here.