---
title: "MarketSimulation"
description: "one run of a systems model template over the record's readings with a strategy laid over it as interventions; the one evaluator steps every flow; deterministic under its seed; stops at its budget with the trajectories it reached"
section: concepts
address: /concepts/marketsimulation
contract: 0476e35e6e275db5
---

# MarketSimulation

one run of a systems model template over the record's readings with a strategy laid over it as interventions; the one evaluator steps every flow; deterministic under its seed; stops at its budget with the trajectories it reached

[figure: MarketSimulation is a work at brand scope. The drawing shows its fields and the objects that they point at.]

| property | value |
|---|---|
| kind | work |
| scope | brand |
| key | the template version, the vertical, the readings hash, the interventions hash and the seed |
| store | postgres |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `template` | [SystemsModelTemplate](/concepts/systemsmodeltemplate) | yes |  |
| `template_version` | `count` | yes |  |
| `vertical` | `id` | yes |  |
| `segment` | `id` | no |  |
| `brand` | `id` | no | absent for a simulation of the shared market |
| `readings_hash` | `hash` | yes | the hash of every chain count, benchmark and stated number the run read, at their versions |
| `interventions` | [Intervention](/concepts/intervention) | yes |  |
| `horizon` | `duration` | yes |  |
| `step` | `duration` | yes |  |
| `samples` | `count` | yes |  |
| `seed` | `count` | yes |  |
| `frame` | `id` | no | the frame it wrote |
| `why_failed` | `text` | no |  |
| `elapsed` | `duration` | no |  |



## Routes that use it
- [`/v1/work/lay_strategy`](/reference/work/lay_strategy) returns it
- [`/v1/work/simulate_market`](/reference/work/simulate_market) returns it