# Albion Online API
> Albion Online game data as an API, powered by the community Albion Online Data Project and the official game-info API (Americas / West server). Pull live Trading Post prices for any item across all the royal cities (Caerleon, Bridgewatch, Lymhurst, Martlock, Thetford, Fort Sterling, Brecilien) and the Black Market — minimum and maximum sell and buy prices broken down by item quality, with the timestamps so you know how fresh each quote is — read the price-and-volume history of any item over the last hours or days, and track the gold price in silver. Look up players by name for their kill and death fame, fame ratio, guild, alliance and kill counts, and search guilds. Item ids follow the simple pattern T4_BAG, T8_PLATE_HELMET (add @1, @2, @3 for enchantment level). This is exactly the data that powers Albion flipping and trading tools, transport and crafting profit calculators, market dashboards, guild and PvP trackers and Discord bots. Prices are in silver. No accounts, no upstream key.

## 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/albion-api/..."
```

## Pricing
- **Free** (Free) — 3,400 calls/Mo, 2 req/s
- **Starter** ($5/Mo) — 44,500 calls/Mo, 5 req/s
- **Pro** ($14/Mo) — 217,000 calls/Mo, 15 req/s
- **Mega** ($39/Mo) — 1,075,000 calls/Mo, 40 req/s

## Endpoints

### Market

#### `GET /v1/gold` — Gold price (silver)

**Parameters:**
- `count` (query, optional, string) — Points 1-100 Example: `10`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/albion-api/v1/gold?count=10"
```

**Response:**
```json
{
    "data": {
        "count": 10,
        "latest": 7330,
        "history": [
            {
                "price": 7330,
                "timestamp": "2026-06-01T00:00:00"
            },
            {
                "price": 7331,
                "timestamp": "2026-05-31T23:00:00"
            },
            {
                "price": 7316,
                "timestamp": "2026-05-31T22:00:00"
            },
            {
                "price": 7297,
                "timestamp": "2026-05-31T21:00:00"
            },
            {
                "price": 7304,
                "timestamp": "2026-05-31T20:00:00"
            },
            {
                "price": 7327,
                "timestamp": "2026-05-31T19:00:00"
            },
            {
                "price": 7335,
                "timestamp": "2026-05-31T18:00:00"
            },
            {
                "price": 7318,
                "timestamp": "2026-05-31T17:00:00"
            },
            {
                "price": 7307,
                "timestamp": "2026-05-31T16:00:00"
            },
            {
                "price": 7289,
                "timestamp": "2026-05-31T15:00:00"
            }
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:30.371Z",
        "request_id": "2ceb084a-d46f-41ee-82a8-f298d3e06da1"
    },
    "status": "ok",
    "message": "Gold retrieved",
    "success": true
}
```

#### `GET /v1/history` — Price & volume history

**Parameters:**
- `item` (query, required, string) — Item id Example: `T4_BAG`
- `city` (query, optional, string) — City Example: `Caerleon`
- `scale` (query, optional, string) — 1|6|24 hours Example: `24`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/albion-api/v1/history?item=T4_BAG&city=Caerleon&scale=24"
```

**Response:**
```json
{
    "data": {
        "item": "T4_BAG",
        "series": [
            {
                "city": "Caerleon",
                "data": [
                    {
                        "avg_price": 7334,
                        "timestamp": "2026-05-02T00:00:00",
                        "item_count": 117
                    },
                    {
                        "avg_price": 7559,
                        "timestamp": "2026-05-03T00:00:00",
                        "item_count": 259
                    },
                    {
                        "avg_price": 7871,
                        "timestamp": "2026-05-04T00:00:00",
                        "item_count": 117
                    },
                    {
                        "avg_price": 5930,
                        "timestamp": "2026-05-05T00:00:00",
                        "item_count": 249
                    },
                    {
                        "avg_price": 7568,
                        "timestamp": "2026-05-06T00:00:00",
                        "item_count": 146
                    },
                    {
                        "avg_price": 7213,
                        "timestamp": "2026-05-07T00:00:00",
                        "item_count": 94
                    },
                    {
                        "avg_price": 6537,
                        "timestamp": "2026-05-08T00:00:00",
                        "item_count": 226
                    },
                    {
           
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/price` — Trading Post prices

**Parameters:**
- `item` (query, required, string) — Item id Example: `T4_BAG`
- `cities` (query, optional, string) — Comma cities Example: `Caerleon,Martlock`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/albion-api/v1/price?item=T4_BAG&cities=Caerleon%2CMartlock"
```

**Response:**
```json
{
    "data": {
        "item": "T4_BAG",
        "count": 10,
        "prices": [
            {
                "city": "Caerleon",
                "buy_max": 2574,
                "buy_min": 1,
                "quality": 1,
                "sell_max": 5898,
                "sell_min": 5250,
                "buy_max_date": "2026-05-31T05:55:00",
                "sell_min_date": "2026-05-31T22:00:00"
            },
            {
                "city": "Caerleon",
                "buy_max": 3847,
                "buy_min": 3847,
                "quality": 2,
                "sell_max": 5469,
                "sell_min": 5469,
                "buy_max_date": "2026-05-31T22:50:00",
                "sell_min_date": "2026-05-31T22:45:00"
            },
            {
                "city": "Caerleon",
                "buy_max": 0,
                "buy_min": 0,
                "quality": 3,
                "sell_max": 5480,
                "sell_min": 5480,
                "buy_max_date": "0001-01-01T00:00:00",
                "sell_min_date": "2026-05-31T22:45:00"
            },
            {
                "city": "Caerleon",
                "buy_max": 0,
                "buy_min": 0,
                "quality": 4,
                "sell_max": 9597,
                "sell_min": 9250,
                "buy_max_date": "0001-01-01T00:00:00",
                "sell_min_date": "2026-05-31T21:35:00"
            },
            {
                "city": "Caerleon",
                "buy_max":
…(truncated, see openapi.json for full schema)
```

### Players

#### `GET /v1/guild` — Search guilds

**Parameters:**
- `name` (query, required, string) — Guild name Example: `Money`

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

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "Money",
        "guilds": [
            {
                "id": "N6Y9p3RsQsScUf5UXlet7A",
                "name": "Money",
                "alliance": null,
                "kill_fame": null,
                "death_fame": 6458890
            },
            {
                "id": "fZkeg87iS_iGJwIGESC1lw",
                "name": "MONEY 001",
                "alliance": null,
                "kill_fame": null,
                "death_fame": 0
            },
            {
                "id": "2km-ULCKQlG2-c0W28JeZw",
                "name": "Money 004",
                "alliance": null,
                "kill_fame": null,
                "death_fame": 0
            },
            {
                "id": "HAJ4E5jlQQKt1_Y2X1N_EA",
                "name": "Money 01",
                "alliance": null,
                "kill_fame": null,
                "death_fame": 0
            },
            {
                "id": "uCfj2A3KSxKIj8_8paAvJQ",
                "name": "money 010",
                "alliance": null,
                "kill_fame": null,
                "death_fame": 0
            },
            {
                "id": "WBehNb8LTdO5u3XQJaDc5Q",
                "name": "Money 02",
                "alliance": null,
                "kill_fame": null,
                "death_fame": 0
            },
            {
                "id": "Qo8LqSxXQJiaQ2rhvG9SWw",
                "name": "Money 03",
                "alliance": n
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/player` — Search players

**Parameters:**
- `name` (query, required, string) — Player name Example: `Robinhood`

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

**Response:**
```json
{
    "data": {
        "count": 10,
        "query": "Robinhood",
        "players": [
            {
                "id": "nU1Y8JrkRrW8lCLMhPZFpQ",
                "name": "RobinHood",
                "guild": null,
                "alliance": null,
                "gvg_kills": null,
                "kill_fame": 0,
                "death_fame": 0,
                "fame_ratio": 0,
                "total_kills": null
            },
            {
                "id": "2rR2UOYvSYyPy5WQCnBHuQ",
                "name": "RobinHood0",
                "guild": null,
                "alliance": null,
                "gvg_kills": null,
                "kill_fame": 0,
                "death_fame": 0,
                "fame_ratio": 0,
                "total_kills": null
            },
            {
                "id": "M1Rd9IzcSCi2NDBYwg7hcw",
                "name": "RobinHood0",
                "guild": null,
                "alliance": null,
                "gvg_kills": null,
                "kill_fame": 0,
                "death_fame": 0,
                "fame_ratio": 0,
                "total_kills": null
            },
            {
                "id": "l00n3T9vQqKTxm64Ik_J2Q",
                "name": "robinhood00",
                "guild": null,
                "alliance": null,
                "gvg_kills": null,
                "kill_fame": 0,
                "death_fame": 21720,
                "fame_ratio": 0,
                "total_kills": null
            },
            
…(truncated, see openapi.json for full schema)
```

### Reference

#### `GET /v1/cities` — Markets list

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

**Response:**
```json
{
    "data": {
        "note": "Use these city names (or their no-space form) in the cities= parameter.",
        "count": 8,
        "cities": [
            "Caerleon",
            "Bridgewatch",
            "Lymhurst",
            "Martlock",
            "Thetford",
            "Fort Sterling",
            "Brecilien",
            "Black Market"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.212Z",
        "request_id": "daa126bc-9767-4128-811c-57155ea0b715"
    },
    "status": "ok",
    "message": "Cities retrieved",
    "success": true
}
```

### Meta

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

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

**Response:**
```json
{
    "data": {
        "note": "Albion Online data (Americas/West server). /v1/price?item=T4_BAG&cities=Caerleon,Bridgewatch = current Trading Post sell/buy prices per city & quality (item ids look like T4_BAG, T8_PLATE_HELMET, add @1 for enchant); /v1/history?item=T4_BAG&city=Caerleon&scale=24 = price & volume history; /v1/gold = the gold price in silver; /v1/player?name=Robinhood = search players (kill fame, guild, kills); /v1/guild?name=Money Guild = search guilds; /v1/cities = the royal cities & Black Market. Prices in silver. Community-sourced market data from the Albion Online Data Project.",
        "source": "Albion Online Data Project (albion-online-data.com) + Albion game-info API",
        "endpoints": [
            "/v1/price",
            "/v1/history",
            "/v1/gold",
            "/v1/player",
            "/v1/guild",
            "/v1/cities",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T00:03:35.259Z",
        "request_id": "fba876f5-e702-4eaf-9d71-3f090a20acf4"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


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