# EVE Online API
> EVE Online game data as an API, from CCP\x27s official ESI service. Check the live Tranquility server status and how many capsuleers are online right now, look up any item type by name or id (group, volume, mass and description), get the market reference price (adjusted and average) of any item, pull a regional order book with the best buy and sell price, the spread and the top orders (defaults to The Forge, the Jita trade hub that drives the whole economy), inspect any solar system by name for its security status, planets, stargates and stations, browse regions, and look up player alliances by name (ticker, founding date, executor corporation). Every name resolves to an id automatically, and a batch resolver turns lists of system, item, region, alliance, corporation and character names into ids in one call. Perfect for market and trading tools, industry and mining calculators, killboards, route planners, intel and fleet tools, and EVE third-party apps. No accounts, no upstream key. Official CCP ESI data.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/eve-api/..."
```

## Pricing
- **Free** (Free) — 3,500 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 45,500 calls/Mo, 5 req/s
- **Pro** ($15/Mo) — 222,000 calls/Mo, 15 req/s
- **Mega** ($40/Mo) — 1,090,000 calls/Mo, 40 req/s

## Endpoints

### Server

#### `GET /v1/status` — Tranquility server status

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/status"
```

**Response:**
```json
{
    "data": {
        "vip": false,
        "online": true,
        "players": 22722,
        "start_time": "2026-05-31T11:01:58Z",
        "server_version": "3366957"
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.442Z",
        "request_id": "26d3367d-183e-4c10-9d3b-bbcdc03d8771"
    },
    "status": "ok",
    "message": "Status retrieved",
    "success": true
}
```

### Universe

#### `GET /v1/region` — Region by name/id

**Parameters:**
- `name` (query, required, string) — Region name Example: `The Forge`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/region?name=The+Forge"
```

**Response:**
```json
{
    "data": {
        "region": {
            "id": 10000002,
            "name": "The Forge",
            "description": "\"The greater the State becomes, the greater humanity under it flourishes.\"",
            "constellations": 13
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.589Z",
        "request_id": "1c7ee2fe-3e0d-44f1-90bf-1491d1cc2c0d"
    },
    "status": "ok",
    "message": "Region retrieved",
    "success": true
}
```

#### `GET /v1/resolve` — Batch name->id resolver

**Parameters:**
- `names` (query, required, string) — Comma names Example: `Jita,Tritanium`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/resolve?names=Jita%2CTritanium"
```

**Response:**
```json
{
    "data": {
        "resolved": {
            "systems": [
                {
                    "id": 30000142,
                    "name": "Jita"
                }
            ],
            "alliances": [
                {
                    "id": 99005382,
                    "name": "Jita Holding Inc."
                }
            ],
            "characters": [
                {
                    "id": 243070982,
                    "name": "Tritanium"
                }
            ],
            "corporations": [
                {
                    "id": 383768304,
                    "name": "jion ss Corp"
                }
            ],
            "inventory_types": [
                {
                    "id": 34,
                    "name": "Tritanium"
                }
            ]
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.697Z",
        "request_id": "e6509e32-5572-48ae-9c7a-c8a552c136f9"
    },
    "status": "ok",
    "message": "Resolved",
    "success": true
}
```

#### `GET /v1/system` — Solar system by name/id

**Parameters:**
- `name` (query, required, string) — System name Example: `Jita`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/system?name=Jita"
```

**Response:**
```json
{
    "data": {
        "system": {
            "id": 30000142,
            "name": "Jita",
            "planets": 8,
            "star_id": 40009076,
            "stations": 18,
            "stargates": 7,
            "security_class": "B",
            "security_status": 0.95,
            "constellation_id": 20000020
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.811Z",
        "request_id": "921c7594-f71b-43b1-b479-b101900481f0"
    },
    "status": "ok",
    "message": "System retrieved",
    "success": true
}
```

#### `GET /v1/type` — Item type by name/id

**Parameters:**
- `name` (query, required, string) — Item name Example: `Tritanium`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/type?name=Tritanium"
```

**Response:**
```json
{
    "data": {
        "type": {
            "id": 34,
            "mass": 0,
            "name": "Tritanium",
            "volume": 0.01,
            "capacity": 0,
            "group_id": 18,
            "published": true,
            "description": "The main building block in space structures. A very hard, yet bendable metal. Cannot be used in human habitats due to its instability at atmospheric temperatures. Very common throughout the central regions of known universe. May be obtained by reprocessing the following ores and their variations available in high security status star systems: veldspar, scordite, and plagioclase. It is also present in huge amounts in rare ores such as spodumain, bezdnacine, rakovene and talassonite. Tritanium can",
            "portion_size": 1,
            "market_group_id": 1857
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.951Z",
        "request_id": "4c5145d3-b959-4a72-9751-94309d25f221"
    },
    "status": "ok",
    "message": "Type retrieved",
    "success": true
}
```

### Market

#### `GET /v1/orders` — Regional order book

**Parameters:**
- `type` (query, required, string) — Item name/id Example: `Tritanium`
- `region` (query, optional, string) — Region name/id Example: `The Forge`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/orders?type=Tritanium&region=The+Forge"
```

**Response:**
```json
{
    "data": {
        "spread": -0.92,
        "type_id": 34,
        "best_buy": 3.82,
        "top_buys": [
            {
                "price": 3.82,
                "duration": 90,
                "min_volume": 1,
                "location_id": 60004360,
                "volume_remain": 34000000
            },
            {
                "price": 3.82,
                "duration": 90,
                "min_volume": 1,
                "location_id": 1042508032148,
                "volume_remain": 60643419
            },
            {
                "price": 3.82,
                "duration": 90,
                "min_volume": 1,
                "location_id": 60003760,
                "volume_remain": 49000000
            },
            {
                "price": 3.81,
                "duration": 90,
                "min_volume": 1,
                "location_id": 60003760,
                "volume_remain": 58461063
            },
            {
                "price": 3.81,
                "duration": 30,
                "min_volume": 1,
                "location_id": 60003760,
                "volume_remain": 5000000
            },
            {
                "price": 3.8,
                "duration": 90,
                "min_volume": 1,
                "location_id": 1042508032148,
                "volume_remain": 6418770
            },
            {
                "price": 3.8,
                "duration": 90,
                "min_volume": 1,
                "locatio
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/price` — Market reference price

**Parameters:**
- `type` (query, required, string) — Item name/id Example: `Tritanium`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/price?type=Tritanium"
```

**Response:**
```json
{
    "data": {
        "type_id": 34,
        "average_price": 3.93,
        "adjusted_price": 2.9591927992537532
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:36.423Z",
        "request_id": "2de12faf-3b55-46c1-818a-cdf9f1ff3eb8"
    },
    "status": "ok",
    "message": "Price retrieved",
    "success": true
}
```

### Players

#### `GET /v1/alliance` — Alliance by name/id

**Parameters:**
- `name` (query, required, string) — Alliance name Example: `Goonswarm Federation`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/alliance?name=Goonswarm+Federation"
```

**Response:**
```json
{
    "data": {
        "alliance": {
            "id": 1354830081,
            "name": "Goonswarm Federation",
            "ticker": "CONDI",
            "founded": "2010-06-01T05:36:00Z",
            "creator_id": 240070320,
            "faction_id": null,
            "executor_corporation_id": 1344654522
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:36.543Z",
        "request_id": "ae3aecca-3183-4b73-b024-b5abb8d2ef8e"
    },
    "status": "ok",
    "message": "Alliance retrieved",
    "success": true
}
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/eve-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "EVE Online data. Names resolve to ids automatically. /v1/status = Tranquility server status (players online); /v1/type?name=Tritanium = an item type (group, volume, mass, description); /v1/price?type=Tritanium = the market reference price (adjusted & average); /v1/orders?type=Tritanium&region=The Forge = a regional order book with best buy/sell, spread and top orders (defaults to The Forge / Jita); /v1/system?name=Jita = a solar system (security status, planets, stargates, stations); /v1/region?name=The Forge = a region; /v1/alliance?name=Goonswarm Federation = an alliance (ticker, founded, executor); /v1/resolve?names=Jita,Tritanium = batch name→id lookup. Official CCP ESI data.",
        "source": "EVE Online ESI (esi.evetech.net)",
        "endpoints": [
            "/v1/status",
            "/v1/type",
            "/v1/price",
            "/v1/orders",
            "/v1/system",
            "/v1/region",
            "/v1/alliance",
            "/v1/resolve",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:36.588Z",
        "request_id": "5319fec4-aef7-4742-8d4f-ec37f4fea8d3"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/eve-api
OpenAPI spec: https://www.oanor.com/api/eve-api/openapi.json