Skip to main content Link Search Menu Expand Document (external link)

!! These tools are not affiliated with Albion Online !!
!! or Sandbox Interactive GmbH !!

Welcome to the Albion Data Project!

The goal of this project is to collect and distribute realtime information for Albion Online. This is achieved with a downloadable client that monitors network traffic specifically for Albion Online, identifies the relevant information, and then ships it off to a central server which distributes the information to anyone who wants it.

Click here to download the client.

Client download stats

Player Information

If you would like to help the Albion Data Project, and all the web sites and applications that use the data provided by it, then the best thing you can do is download our client and run it whenever you’re playing Albion Online.

The most recent releases can be found here: https://github.com/ao-data/albiondata-client/releases

Where Can I View The Data I Upload?

Note that the client can only upload the market orders that you load in game, so be sure to browse the market for the prices that you need. When a price is uploaded, it is visible in the data immediately.

The best way to make use of the data is by using the tools that are built on it:

  • Tools4Albion provides calculators for crafting, farming, and reprocessing. Has a lot of useful information for users and developers alike.
  • AlbionOnline2d pulls the latest information from the database and shows different selling metrics for the Auction Houses.
  • Farm Profit Calculator utilizes market data to provide a guide to the best farming options for you based on current prices.
  • Albion Helper (forked from Albion Assistant) A discord bot to retrieve prices from Albion Online Data Project APIs.

If you have a project you’d like to have listed here, contact a maintainer in discord to talk about it.

Market data can be also be obtained through the API

API Enpoints

For any of the following urls, .json is optional and is the default, and .json can be replaced with .xml for xml

API Endpoint Rate Limits

  • 180 per 1 minute
  • 300 per 5 minutes

“I WANT ALL THE DATA FROM THE API”

Well, you can. You just need to do it in a way that doesn’t hit the API rate limit. Combine the item’s you want to get data on, as well as locations. There’s about a 2000 character limit for the url length. You can fit a lot of items and all the locations in a single call.

Something like this (too big to show on the page!).

We also ask that if you are going to write a service that continually hits the API, please use Gzip compression. The server and bandwidth isn’t free and while the monthly bandwidth limit hasn’t been exceeded that we’re aware of, the more people that use the project and it’s API, the closer we get to overages.

Spreadsheets

Many people find it useful to load these APIs in spreadsheets such as Microsoft Excel or Google Sheets. There is no single best way to do this, but some of the common ways are as follows:

  • Excel Power Query
  • Google Sheets IMPORTXML
    • Example: =IMPORTXML("https://www.albion-online-data.com/api/v2/stats/prices/T4_BAG.xml?locations=Caerleon&qualities=2","//ArrayOfMarketResponse/MarketResponse")
  • Google Sheets ImportJSON (third-party script)
    • Note: Some people have noticed issues with ImportJSON and repeating rows
    • Example: =ImportJSON("https://www.albion-online-data.com/api/v2/stats/prices/T4_BAG.json?locations=Caerleon&qualities=2", "", "noHeaders")

Related Albion Tools

Configuration

You can see all of the current available command line parameters by launching the executable with "C:\Program Files\Albion Data Client\albiondata-client.exe" -h or by adding -h to the shortcut.

Parameters

At the time of writing the following are the available (well-supported) configuration options:

"C:\Program Files\Albion Data Client\albiondata-client.exe" -h
  -d    If specified no attempts will be made to upload data to remote server.
  -debug
        Enable debug logging.
  -events string
        Whitelist of event IDs to output messages when debugging. Comma separated.
  -events-ignore string
        Blacklist of event IDs to hide messages when debugging. Comma separated.
  -i string
        Base URL to send PUBLIC data to, can be 'nats://', 'http://' or 'noop' and can have multiple uploaders. Comma separated. (default "nats://public:thenewalbiondata@www.albion-online-data.com:4222")
  -ignore-decode-errors
        Ignore the decoding errors when debugging
  -l string
        Listen on this comma separated devices instead of all available
  -minimize
        Automatically minimize the window.
  -o string
        Parses a local file instead of checking albion ports.
  -operations string
        Whitelist of operation IDs to output messages when debugging. Comma separated.
  -operations-ignore string
        Blacklist of operation IDs to hide messages when debugging. Comma separated.
  -p string
        Base URL to send PRIVATE data to, can be 'nats://', 'http://' or 'noop' and can have multiple uploaders. Comma separated.

Disable Start With Windows

  1. Open up the program Task Scheduler.
  2. Click on the Task Scheduler Library in the left side pane.
  3. Find the task with the name Albion Data Client.
  4. Right-click Disable to disable the task.

Troubleshooting

Starting the client via the command line will allow the error message to persist.

  • Windows
    • Open a run command prompt window with WIN + r
    • Enter "C:\Program Files\Albion Data Client\albiondata-client.exe"
    • View application output
  • MacOS
    • Open a terminal COMMAND + SPACE and type terminal
    • Enter /path/to/albiondata-client
    • View application output
  • Linux
    • Open a terminal (too many ways to list, if you use Linux, you should know how)
    • Enter /path/to/albiondata-client
    • View application output

Client crashing

Device/Adapter Errors

Includes the following Error Messages:

  • “No such device exists”
  • “Error opening adapter: The system cannot find the device specified. (20)”
  • “eth0: You don’t have permission to capture on that device (socket: Operation not permitted)” (Linux/MacOS specific)

This means the client can’t attach it self to the network interface to capture Albion Online data.

  • Windows
    • Open a command prompt
    • Type ipconfig.exe /all
    • Look for the network adapter that give’s you connectivity and find the Physical Address line:Alt text
    • Start the client with the -l (lower case L) argument, replacing the physical address of your card: "C:\Program Files\Albion Data Client\albiondata-client.exe" -l "B4-2E-99-31-90-E2"
  • MacOS
    • Open a terminal
    • Type ifconfig
    • Look for the network adapter that give’s you connectivity and find the Physical Address line:Alt text
    • Start the client with the -l (lower case L) argument, replacing the physical address of your card: /path/to/albiondata-client -l "14:7D:DA:DB:C6:29"
  • Linux (essentially the same as MacOS)
    • Open a terminal
    • Type ifconfig
    • Look for the network adapter that give’s you connectivity and find the Physical Address line:Alt text
    • Start the client with the -l (lower case L) argument, replacing the physical address of your card: /path/to/albiondata-client -l "7E-13-57-B4-C4-3B"

MacOS/Linux needs sudo

Original developer discussing the issue.

Running the Albion Online Data client with sudo is the easiest way to get going. But, you can work around needing full sudo if you understand Linux/MacOS permssions.

The following has been copied and modified to fit this project’s use.

Note: aod group is short for “Albion Online Data”. You’ll need to substitute /path/to/albiondata-client with the actual path to your client.

Add a capture group and add yourself to it:

Source: https://github.com/bettercap/bettercap/issues/783#issuecomment-1021912001
sudo groupadd aod
sudo usermod -a -G aod $USER

Next, change the group of tcpdump and set permissions:

sudo chgrp aod /path/to/albiondata-client
sudo chmod 750 /path/to/albiondata-client

Client is getting “902” error code

This means you are sending far too much data to the ingest server. Slow down your market searching and/or next/back button clicks.

Developer Information

If you’re building something to consume the data published by the Albion Data Project here are some things you will need to know:

  • NATS Connection String: nats://public:thenewalbiondata@www.albion-online-data.com:4222
  • NATS Topics:
    • goldprices.deduped
    • marketorders.deduped
    • mapdata.deduped
  • Structure of data messages: albiondata-client/lib

A note on duplicate messages. As information comes into the NATS Server it is looked at and deduplicated over a 5 minute window. As a subscriber the goal is that you should only get the same message once every 5 minutes. This is of course open for change as we go however. The reason we are sending the same message at all is two fold.

New people connecting to the network may have missed previous messages. Along with that however we don’t have a good way of noticing things like market orders completing. To remove market orders from your application the current best idea around is to keep track of the last time an order was seen, and then after not seeing it for X hours remove it has probably having been completed.

Database Table Exports

You can find daily table dumps on the server at https://www.albion-online-data.com/database/. The export contains a .sql file for each table, and a .zip file for each table that contains a tab-separated .txt data file which can be imported into MySQL using common tools.

Albion Data Projects

Contact Us

The best way to get in touch with us is on the Albion Online Fansites Discord server in either the #proj-albiondata or the #developers channel. A permanent invite link can be found here: https://discord.gg/TjWdq24

Is This Allowed

Our position is quite simple. As long as you just look and analyze we are ok with it. The moment you modify or manipulate something or somehow interfere with our services we will react (e.g. perma-ban, take legal action, whatever).

~MadDave, Technical Lead at Sandbox Interactive for Albion Online, source