# UnlockImpact

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>calculationVersion</code> | Yes | <code>string</code> | Allowed: <code>unlock-impact-v1</code>, <code>unlock-impact-v2</code> |
| <code>unlockIds</code> | Yes | Array of <code>string</code> | — |
| <code>sourceLaunchPlanId</code> | No | <code>string</code> | — |
| <code>sourceObservation</code> | No | [UnlockImpactSourceObservation](/api-reference/schemas/unlock-impact-source-observation/) | — |
| <code>inputHash</code> | No | [Hash](/api-reference/schemas/hash/) | — |
| <code>inputSnapshot</code> | No | [UnlockImpactInputSnapshot](/api-reference/schemas/unlock-impact-input-snapshot/) | — |
| <code>correlationGroups</code> | No | Array of <code>object</code> | — |
| <code>correlationGroups&#91;&#93;.groupId</code> | Yes | <code>string</code> | — |
| <code>correlationGroups&#91;&#93;.unlockIds</code> | Yes | Array of <code>string</code> | — |
| <code>correlationGroups&#91;&#93;.totalUnlockedToken</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>correlationGroups&#91;&#93;.confidencePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>correlationGroups&#91;&#93;.sellPressureTokenRange</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>correlationGroups&#91;&#93;.sellPressureTokenRange.p5</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>correlationGroups&#91;&#93;.sellPressureTokenRange.p50</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>correlationGroups&#91;&#93;.sellPressureTokenRange.p95</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>sellPressureTokenRange</code> | No | <code>object</code> | Additional properties rejected |
| <code>sellPressureTokenRange.p5</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>sellPressureTokenRange.p50</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>sellPressureTokenRange.p95</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>sellPressureQuoteRange</code> | No | <code>object</code> | Additional properties rejected |
| <code>sellPressureQuoteRange.p5</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>sellPressureQuoteRange.p50</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>sellPressureQuoteRange.p95</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>priceImpactPipsRange</code> | No | <code>object</code> | Additional properties rejected |
| <code>priceImpactPipsRange.p5</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>priceImpactPipsRange.p50</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>priceImpactPipsRange.p95</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>expectedSellPressureToken</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>expectedSellPressureQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>usableDepthAfterQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>expectedPriceImpactPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>requiredStableReserveQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>recommendedRangeShiftPips</code> | Yes | <code>integer</code> | — |
| <code>treasuryRiskPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>confidencePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>warnings</code> | Yes | Array of <code>string</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/UnlockImpact</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).