object — Additional properties rejected
| Field | Required at this level | Type | Description and constraints |
|---|---|---|---|
seed |
No | string |
Min length: 8; Max length: 200 |
stepCount |
No | integer |
Minimum: 1; Maximum: 365 |
startingPortfolioQuote |
No | string |
Pattern: ^[1-9][0-9]{0,77}$ |
startingDepthQuote |
No | string |
Pattern: ^[1-9][0-9]{0,77}$ |
startingInventoryPips |
No | integer |
Minimum: 0; Maximum: 1000000 |
objective |
No | object |
Additional properties rejected |
objective.metric |
Yes | string |
Allowed: ENDING_VALUE_P50, MINIMUM_DEPTH_P5, GAS_COST_P50, DRAWDOWN_P95, RESERVE_BREACH_PROBABILITY |
objective.direction |
Yes | string |
Allowed: MAXIMIZE, MINIMIZE |
baselineScenario |
No | object |
Additional properties rejected |
baselineScenario.id |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
baselineScenario.name |
Yes | string |
Min length: 3; Max length: 160 |
baselineScenario.kind |
Yes | string |
Allowed: HISTORICAL_REPLAY, BULL, BEAR, SIDEWAYS, LIQUIDITY_CRISIS, TOKEN_UNLOCK, LARGE_BUYER, LARGE_SELLER, LIQUIDITY_WITHDRAWAL, GAS_SPIKE, ORACLE_OUTAGE, COMBINED |
baselineScenario.driftPipsPerStep |
Yes | integer |
Minimum: -1000000; Maximum: 1000000 |
baselineScenario.volatilityPipsPerStep |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.liquidityWithdrawalPips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.oneSidedFlowPips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.gasIncreasePips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.oracleOutageStep |
No | integer |
Minimum: 0; Maximum: 364 |
baselineScenario.historicalReturnPips |
No | Array of integer |
Min items: 1; Max items: 365 |
baselineScenario.protocolFeePips |
No | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.platformFeePips |
No | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.unlocks |
Yes | Array of object |
Max items: 256 |
baselineScenario.unlocks[].id |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$ |
baselineScenario.unlocks[].unlocksAt |
Yes | string |
Format: date-time; Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ |
baselineScenario.unlocks[].tokenAmount |
Yes | string |
Pattern: ^[1-9][0-9]{0,77}$ |
baselineScenario.unlocks[].recipientCategory |
Yes | string |
Allowed: TEAM, INVESTOR, COMMUNITY, TREASURY, ECOSYSTEM, OTHER |
baselineScenario.unlocks[].expectedSaleParticipationPips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.unlocks[].confidencePips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
baselineScenario.unlocks[].correlationGroup |
No | string |
Min length: 1; Max length: 120 |
baselineScenario.unlocks[].evidenceHash |
No | string |
Pattern: ^0x[0-9a-fA-F]{64}$ |
alternatives |
No | Array of object |
Max items: 3 |
alternatives[].label |
Yes | string |
Min length: 1; Max length: 120 |
alternatives[].scenario |
Yes | object |
Additional properties rejected |
alternatives[].scenario.id |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,159}$ |
alternatives[].scenario.name |
Yes | string |
Min length: 3; Max length: 160 |
alternatives[].scenario.kind |
Yes | string |
Allowed: HISTORICAL_REPLAY, BULL, BEAR, SIDEWAYS, LIQUIDITY_CRISIS, TOKEN_UNLOCK, LARGE_BUYER, LARGE_SELLER, LIQUIDITY_WITHDRAWAL, GAS_SPIKE, ORACLE_OUTAGE, COMBINED |
alternatives[].scenario.driftPipsPerStep |
Yes | integer |
Minimum: -1000000; Maximum: 1000000 |
alternatives[].scenario.volatilityPipsPerStep |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.liquidityWithdrawalPips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.oneSidedFlowPips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.gasIncreasePips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.oracleOutageStep |
No | integer |
Minimum: 0; Maximum: 364 |
alternatives[].scenario.historicalReturnPips |
No | Array of integer |
Min items: 1; Max items: 365 |
alternatives[].scenario.protocolFeePips |
No | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.platformFeePips |
No | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.unlocks |
Yes | Array of object |
Max items: 256 |
alternatives[].scenario.unlocks[].id |
Yes | string |
Pattern: ^[a-zA-Z0-9][a-zA-Z0-9:_-]{2,152}$ |
alternatives[].scenario.unlocks[].unlocksAt |
Yes | string |
Format: date-time; Pattern: ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$ |
alternatives[].scenario.unlocks[].tokenAmount |
Yes | string |
Pattern: ^[1-9][0-9]{0,77}$ |
alternatives[].scenario.unlocks[].recipientCategory |
Yes | string |
Allowed: TEAM, INVESTOR, COMMUNITY, TREASURY, ECOSYSTEM, OTHER |
alternatives[].scenario.unlocks[].expectedSaleParticipationPips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.unlocks[].confidencePips |
Yes | integer |
Minimum: 0; Maximum: 1000000 |
alternatives[].scenario.unlocks[].correlationGroup |
No | string |
Min length: 1; Max length: 120 |
alternatives[].scenario.unlocks[].evidenceHash |
No | string |
Pattern: ^0x[0-9a-fA-F]{64}$ |
Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.
Exact definition: #/components/schemas/ResearchPlanningAssumptions in the OpenAPI contract.