---
title: "MarketTwinState"
description: "the state of a twin at one step of one simulation: the level of every stock, so the twin's trajectory is facts in gold and never a rebuild"
section: concepts
address: /concepts/markettwinstate
contract: 0476e35e6e275db5
---

# MarketTwinState

the state of a twin at one step of one simulation: the level of every stock, so the twin's trajectory is facts in gold and never a rebuild

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

| property | value |
|---|---|
| kind | fact |
| scope | brand |
| key | the twin, the step and the time |
| store | postgres+lake |
| family | market |



## Fields


| field | type | required | note |
|---|---|---|---|
| `twin` | `id` | yes |  |
| `simulation` | `id` | yes |  |
| `step` | `count` | yes |  |
| `at` | `time` | yes |  |
| `levels` | [StockLevel](/concepts/stocklevel) | yes |  |



## Routes that use it
No route takes or returns MarketTwinState directly. The record holds it, and the objects that point at it reach it.