Economy Data Dumps - Coder Documentation

cogg - 479 days ago - Edited 83 days agoLink

The servers generate daily logs of economic activity. This data is publicly accessible and may have many uses. For example:

General Information

Files are uploaded daily, at around 0 UTC. They contain data from the previous 24 hours. They should be accessible indefinitely, and once generated, they will not be modified (with the exception of the item schema).

The format should be reasonably stable, but some fields might change, and new information might be added to future dumps. Programs consuming the data shouldn't make assumptions. For instance, a ship ID might be present in the log file but missing from the active ship file.

Dumps do not include any data from the labs.

Dumps are stored at URLs of the form:{INSTANCE}/econ/{YEAR}_{MONTH}_{DAY}/{FILE}

FILE: summary.json

This file is un-compressed JSON, and contains some hopefully convenient stats. The hope is that if you want to build a simple app or run a quick test, you can just check the summary files without parsing the larger dumps. The file contains these fields:

FILE: ships.json.gz

This file is GZIP-COMPRESSED JSON, containing an array of objects. Each object represents a ship that was active and saved during that day, and has these fields:

FILE: log.json.gz

This file is GZIP-COMPRESSED JSON, containing an array of objects. Each object represents either an item being taken from an item crate by a ship, or an item crate being destroyed. These objects contain the following fields:

Items intentionally ejected and picked up by the same ship are not included in this file.

FILE: item_schema.json

[NOTE] Only a single instance of this file is generated:{INSTANCE}/econ/item_schema.json

This file will change, but only between updates. Due to aggressive caching, it might take some time to obtain a fresh copy. If you are having trouble, you can try "cache busting" by appending a query parameter.

This file is un-compressed JSON, containing an array of objects. Each object represents a kind of item in the game. The meaning of most fields should be fairly obvious upon some inspection. The same information with more details can be found in the game code, but it seems stupid to tell users that they need to reverse the game to build anything with this.

FILE: bot_drops.txt

[NOTE] Only a single instance of this file is generated:{INSTANCE}/econ/bot_drops.txt

The same points about updates and caching from item_schema.json apply to this.

This file is user-readable plain-text, and lists the drop rates for most bots. Older bots such as those from Vulture are not included.

Initial Dump URLs

PROD: 2022_11_23

TEST: 2022_11_13

oofer22 - 474 days ago Link


Godplayer - 473 days ago Link


777 - 469 days ago - Edited 469 days agoLink


you have a fucking update bring everything back to how it was 2 months ago!

MetroFaith - 468 days ago Link


AbestTeaLady - 468 days ago Link

This is really a really good update cogg.

Galileo Majstor - 467 days ago Link


goldshadow1 - 467 days ago Link

this is the only part of the update thats good the locking part isnt

tulp69 - 462 days ago Link

Finally something good about this update

Checkmate - 457 days ago - Edited 455 days agoLink
Checkmate - 456 days ago - Edited 455 days agoLink


Edvaldo - 355 days ago Link

ok ta bom

thiago1255 - 11 days ago Link

Me reading this again:


Sorry, anonymous users can not post in threads.