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 Strings

  • Americas: nats://public:thenewalbiondata@nats.albion-online-data.com:4222
  • Asia: nats://public:thenewalbiondata@nats.albion-online-data.com:24222
  • Europe: nats://public:thenewalbiondata@nats.albion-online-data.com:34222

NATS Topics

  • goldprices.ingest — all gold prices from data clients (including duplicates)
  • marketorders.ingest — all orders from data clients (including duplicates)
  • markethistories.ingest — all histories from data clients (including duplicates)
  • goldprices.deduped — deduped gold prices
  • marketorders.deduped — deduped market orders
  • markethistories.deduped — deduped market histories

Data message structure: albiondata-client/lib

Timestamps

Note: Timestamps on Market History data and Bandit Event are in ticks. To convert ticks to epoch (a more common time format), use:

(ticks - 621355968000000000) / 10000000

Example: (638181504000000000 - 621355968000000000) / 10000000 → 1682553600. Use unixtimestamp.com to convert 1682553600 to a human-readable format (e.g. 2023-04-27 00:00:00 UTC). This should be enough to convert timestamps in your language of choice.

Bandit Event

Message schema: {"EventTime"=>639057896373527168, "AdvanceNotice"=>true}

  • AdvanceNotice true — the event has not started yet. EventTime is when the event starts.
  • AdvanceNotice false — EventTime is when the event ends.

EventTime is in C# ticks (see Timestamps above for conversion).

Database Table Exports

Daily table dumps are available at:

Albion Data Projects