PUBLIC API · v1

EVE Emptiness API

A read-only, bot-friendly HTTP API over activity intelligence for EVE Online's ~4,900 accessible k-space systems — quiet & busy systems, per-system history, PvP hotspots, sovereignty timers, chokepoints, the full spatial map, and capital jump-range reachability. No auth. Cached heavily. Built for agents.

checking service…

Base URLhttps://jumps.tovdc.com/api/v1
DiscoveryGET /api/v1 — machine catalog
Agent quickstart/llms.txt

Conventions

Endpoints

GET /systems

List / filter / sort every system by activity, security, trends, and flags. Default sort: activity ascending (quietest first).

GET /systems/{id}

One system, full live payload.

GET /systems/{id}/history?days=90

Daily activity totals, up to 365 days.

GET /systems/{id}/circadian

24-hour activity distribution.

GET /systems/{id}/sovereignty?days=30

Null-sec ADM change timeline.

GET /search?q=jita

System-name autocomplete (min 2 chars).

GET /regions

All regions with system counts.

GET /gate-camps

Chokepoints ranked by betweenness centrality, with a composite gate-camp score.

GET /forecast-inputs

Bulk forecaster feed: 35 days of daily totals + circadian/trend/topology context per system. Build your own model on it.

GET /forecast/systems

Tomorrow's per-system forecast: predicted jumps/kills, hotspot probability + drivers, quiet window. Paginated.

GET /forecast/hotspots

Systems ranked by predicted fight probability (sort=prob) or unusualness vs their own baseline (sort=surprise); limit default 50.

GET /forecast/briefs

Daily intel briefs (galaxy + regions), LLM-written; status: "fallback" marks the statistical summary.

GET /forecast/accuracy

Daily accuracy per model incl. naive baselines — MAE, directional accuracy, Brier, quiet precision/recall.

GET /fights/hotspots

Live PvP hotspots (data.hotspots + data.summary) with classification and prime hour.

GET /fights/timers

Upcoming sovereignty campaign timers with defender names.

GET /map

Every system with 3D coordinates (meters) + overlay flags — one big spatial payload.

GET /jump-range?staging=Jita&mode=fastest

Gate-jumps from a staging system to every system (data.jumps = { id: jumps }).

GET /wormholes

Live Thera/Turnur connections fused with activity (k-space) or static class/effect (J-space); meta.summary counts by hub/security/ship-size/EOL.

GET /stats

Dataset coverage + collection health.

GET /health

Liveness + last-collection timestamp.

Filters for /systems

ParamValuesMeaning
securityhigh · low · nullSecurity band (displayed sec)
region / constellationnameExact match (case-insensitive)
activity_min / _max0–100Activity score bounds
jumps_min / _maxintLive jumps (last hour)
kills_min / _maxintLive PvP kills
min_consistency0–10030-day quiet consistency
max_hub_distanceintMax gate jumps to a trade hub
activity_typepve · pvp · mixed · deadDominant flavor
trendincreasing · decreasing · stable7-day trend
has_npc_station · quiet_now · incursion · sov_campaign · fw_contested · wormhole_accesstrue/falseBoolean flag filters
sort / orderactivity, jumps, kills, jumps_24h, consistency, hub, danger, … / asc, descOrdering

Functional examples

Quietest low-sec near a trade hub

curl -s 'https://jumps.tovdc.com/api/v1/systems?security=low&sort=activity&order=asc\
&max_hub_distance=10&page_size=20&fields=name,region,activity_score,consistency_score,hub_distance'

Where are people dying right now

curl -s 'https://jumps.tovdc.com/api/v1/fights/hotspots' | jq '.data.summary'

Capital response reach from a staging system

curl -s 'https://jumps.tovdc.com/api/v1/jump-range?staging=1DQ1-A&mode=fastest'
# light-years computed from /map coords: ly = hypot(dx,dy,dz) / 9.4607304725808e15

Conditional GET (bandwidth-friendly)

ETAG=$(curl -sD - -o /dev/null 'https://jumps.tovdc.com/api/v1/map' | awk '/etag/{print $2}')
curl -s -o /dev/null -w '%{http_code}\n' -H "If-None-Match: $ETAG" 'https://jumps.tovdc.com/api/v1/map'
# -> 304

Data © CCP Games via ESI. Derived metrics free to use. Not endorsed by CCP. Be a good citizen: cache, send a User-Agent, respect the rate limit.  ·  ← back to EVE Emptiness