Citing tradefloor
Cite the version you ran and name the preset. One version can run every shipped preset, and results depend on which one you used.
@software{tradefloor,
author = {Coombes, Simon},
title = {tradefloor: a deterministic market simulator with a limit order book},
version = {0.8.7},
year = {2026},
url = {https://github.com/simoncoombes/tradefloor},
note = {Model preset pt-v20}
}There is no DOI yet, so the version and the repository address identify the software. The repository's CITATION.cff carries the same details, and GitHub's "Cite this repository" button reads it.
In the text, name the model as well, for example: "tradefloor 0.8.7, preset pt-v20, specified in its docs/MODEL.md". How prices are made describes that model.
Details to publish with a result
A citation identifies the software. To let a reader rebuild your market, report these too:
- the tradefloor version and the preset name
- the seeds
- the universe: the
Universe.random(n, seed=...)call or the roster file, and its fingerprint - the economy on day zero, if you set one
- any scenario file, and its digest
A RunManifest records all of these and replays the market. It checks the market and carries no score, so to let a reader check a score, publish the agent's code, the tf.evaluate or tf.rank call and the seeds as well. Reproducibility says what each of these inputs fixes.
License
tradefloor is open source under the MIT license or the Apache License 2.0, at your option.