---
title: "tool si.work.simulate_market"
description: "Runs one systems model template over a market, with the interventions to try and the bounds of the run: The call returns the simulation as work, then the frame that holds what it reached."
section: reference
address: /reference/tools/si-work-simulate_market
contract: 0476e35e6e275db5
---

# tool si.work.simulate_market

Runs one systems model template over a market, with the interventions to try and the bounds of the run: The call returns the simulation as work, then the frame that holds what it reached.

[figure: Over MCP, si.work.simulate_market takes MarketSimulationInput and returns a card whose body is MarketSimulation.]

The call returns the simulation as work, then the frame that holds what it reached. The call needs the work grant at the brand rung.



| | |
|---|---|
| input | [MarketSimulationInput](/concepts/marketsimulationinput) |
| result | a card whose body is [MarketSimulation](/concepts/marketsimulation) |
| read-only | no |
| destructive | no |
| card address | `ui://scale-intelligence/cards/MarketSimulation` |
| HTTP route | [`/v1/work/simulate_market`](/reference/work/simulate_market) |





| field | type | required | note |
|---|---|---|---|
| `template` | [SystemsModelTemplate](/concepts/systemsmodeltemplate) | yes |  |
| `vertical` | `id` | yes |  |
| `segment` | `id` | no |  |
| `brand` | `id` | no |  |
| `interventions` | [Intervention](/concepts/intervention) | yes |  |
| `horizon` | `duration` | no | the template's when absent |
| `samples` | `count` | no | the parameter's when absent |
| `seed` | `count` | no |  |