# DisclosedSimulationStudyInputSnapshot

[All API schemas](/api-reference/schemas/)

<code>object</code> — Additional properties rejected

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>schemaVersion</code> | Yes | Constant <code>simulation-study-input-snapshot-v1</code> | — |
| <code>engineVersion</code> | Yes | Constant <code>digital-twin-pcg64-fixed-v2</code> | — |
| <code>seed</code> | Yes | <code>string</code> | — |
| <code>pathCount</code> | Yes | <code>integer</code> | Allowed: <code>2000</code>, <code>10000</code> |
| <code>stepCount</code> | Yes | <code>integer</code> | Minimum: <code>1</code>; Maximum: <code>365</code> |
| <code>targetTradeSizeQuote</code> | Yes | [PositiveAtomicAmount](/api-reference/schemas/positive-atomic-amount/) | — |
| <code>startingPortfolioQuote</code> | Yes | [PositiveAtomicAmount](/api-reference/schemas/positive-atomic-amount/) | — |
| <code>startingDepthQuote</code> | Yes | [PositiveAtomicAmount](/api-reference/schemas/positive-atomic-amount/) | — |
| <code>startingInventoryPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>scenario.id</code> | Yes | <code>string</code> | — |
| <code>scenario.name</code> | Yes | <code>string</code> | — |
| <code>scenario.kind</code> | Yes | <code>string</code> | Allowed: <code>HISTORICAL&#95;REPLAY</code>, <code>BULL</code>, <code>BEAR</code>, <code>SIDEWAYS</code>, <code>LIQUIDITY&#95;CRISIS</code>, <code>TOKEN&#95;UNLOCK</code>, <code>LARGE&#95;BUYER</code>, <code>LARGE&#95;SELLER</code>, <code>LIQUIDITY&#95;WITHDRAWAL</code>, <code>GAS&#95;SPIKE</code>, <code>ORACLE&#95;OUTAGE</code>, <code>COMBINED</code> |
| <code>scenario.driftPipsPerStep</code> | Yes | <code>integer</code> | Minimum: <code>-1000000</code>; Maximum: <code>1000000</code> |
| <code>scenario.volatilityPipsPerStep</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario.liquidityWithdrawalPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario.oneSidedFlowPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario.gasIncreasePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario.oracleOutageStep</code> | No | <code>integer</code> | Minimum: <code>0</code>; Maximum: <code>364</code> |
| <code>scenario.historicalReturnPips</code> | No | Array of <code>integer</code> | Min items: <code>1</code>; Max items: <code>365</code> |
| <code>scenario.protocolFeePips</code> | No | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario.platformFeePips</code> | No | [Pips](/api-reference/schemas/pips/) | — |
| <code>scenario.unlocks</code> | No | Array of [UnlockTranche](/api-reference/schemas/unlock-tranche/) | Max items: <code>256</code> |
| <code>variants</code> | Yes | Array of [LiquidityPlanVariant](/api-reference/schemas/liquidity-plan-variant/) | Min items: <code>5</code>; Max items: <code>5</code> |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Exact definition: <code>#/components/schemas/DisclosedSimulationStudyInputSnapshot</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).