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"
FieldContent
updatedWhen a jump last reported the system (absent when only seen in a scan or a route)
factionsUpdatedWhen 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
bodyCountBodies 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"
ParameterMeaning
commodityThe game's name of the commodity (tritium, painite…). Required.
modebuy (default: stations selling it, with stock) or sell (stations buying it, with demand)
nearA system's name: distances are counted from it (if EDCN knows the system)
x, y, zOr the reference's coordinates, in light years (what the game's journal gives)
rangeWith a reference: the largest distance, in light years
sortvolume (default: largest stock or demand), price, distance, recent
limit1 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": […]}.

CallFinds
/api/v1/modules?module=a,bStations selling every listed module (the game's symbols: hpt_pulselaser_fixed_small)
/api/v1/ships?ship=a,bStations 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.