Economy Data Dumps - Coder Documentation

cogg - 86 days ago - Edited 74 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:

https://pub.drednot.io/{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: This file is updated as part of the dump process, but only a single copy is stored:

https://pub.drednot.io/{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.

Initial Dump URLs

TEST: 2022_11_13

PROD: 2022_11_23

Votes
27
1
6:1
oofer22 - 81 days ago Link

wha

6:2
Godplayer - 80 days ago Link

good

6:3
777 - 75 days ago - Edited 75 days agoLink

Cogg IDIOT GIVE KEY OLD TAB + NEW FUNCTION

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

6:4
MetroFaith - 75 days ago Link

huh

6:5
AbestTeaLady - 75 days ago Link

This is really a really good update cogg.

6:6
Galileo Majstor - 73 days ago Link

Finally

6:7
goldshadow1 - 73 days ago Link

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

6:8
tulp69 - 68 days ago Link

Finally something good about this update

6:9
Checkmate - 63 days ago - Edited 61 days agoLink
6:10
Checkmate - 62 days ago - Edited 61 days agoLink

Great

6:11

Sorry, anonymous users can not post in threads.