TT Route API Docs

Advanced Pathfinding Infrastructure for EVE Online Developers

Overview

The TT Route API provides a powerful engine for calculating solar system paths in New Eden. It goes beyond standard gate-to-gate calculation by integrating Thera/Turnur wormhole hubs and real-time ESI statistics (Kills & Jumps).

The Endpoint

GET /api/route

Query Parameters

Parameter	Type	Description	Default
`start` Required	String	Starting solar system name (e.g., Jita)	-
`end` Required	String	Destination solar system name (e.g., Amarr)	-
`wps` Optional	String	Comma (`,`) or Equal-sign (`=`) separated systems.	-
`avoid` Optional	String	Systems to bypass, separated by `,` or `=`.	Zarzakh
`pref` Optional	String	`shortest` or `safest`	shortest

Response Format

Responses are returned as a JSON object containing a summary and detailed routes.

{
  "summary": {
    "start": "Jita",
    "end": "DSS-EZ",
    "waypoints": ["Amarr", "BR-6XP"],
    "pref": "shortest",
    "directJumps": 79,
    "theraJumps": 64,
    "recommended": "thera"
  },
  "routes": {
    "direct": [ ... ],
    "thera": [
      {
        "id": 31000005,
        "name": "Thera",
        "security": -0.99,
        "jumps1h": 450,
        "kills1h": 12,
        "wormhole": {
          "type": "K162",
          "signature": "V898",
          "eol": false,
          "age": "2026-01-06T10:00:00Z"
        }
      }
    ]
  },
  "timestamp": "2026-01-06T07:33:11.181Z"
}

Edge Caching (SWR)

Our API is hosted on Vercel's global edge network and uses a Stale-While-Revalidate strategy:

5 Minute Cache: Results are cached for 300 seconds (s-maxage=300).
Background Update: While serving cached data, the system automatically fetches fresh data from ESI and Eve-Scout in the background.
Efficiency: This minimizes load on 3rd party APIs while providing near-zero latency for end-users.

Example Implementation (JavaScript)

const response = await fetch('https://eve-route.vercel.app/api/route?start=Jita&end=DSS-EZ&wps=Amarr=BR-6XP');
const data = await response.json();

console.log(`Recommended path is via ${data.summary.recommended}`);
if (data.summary.theraJumps < data.summary.directJumps) {
    console.log(`Save ${data.summary.directJumps - data.summary.theraJumps} jumps via Thera!`);
}