# IncentiveOptimization

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>optimizerVersion</code> | Yes | Constant <code>incentive-optimizer-v1</code> | — |
| <code>programId</code> | Yes | <code>string</code> | — |
| <code>incrementalLiquidityQuote</code> | Yes | [SignedAtomicAmount](/api-reference/schemas/signed-atomic-amount/) | — |
| <code>incrementalVolumeQuote</code> | Yes | [SignedAtomicAmount](/api-reference/schemas/signed-atomic-amount/) | — |
| <code>incrementalLiquidityRangeQuote</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>incrementalLiquidityRangeQuote.low</code> | Yes | [SignedAtomicAmount](/api-reference/schemas/signed-atomic-amount/) | — |
| <code>incrementalLiquidityRangeQuote.high</code> | Yes | [SignedAtomicAmount](/api-reference/schemas/signed-atomic-amount/) | — |
| <code>incrementalVolumeRangeQuote</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>incrementalVolumeRangeQuote.low</code> | Yes | [SignedAtomicAmount](/api-reference/schemas/signed-atomic-amount/) | — |
| <code>incrementalVolumeRangeQuote.high</code> | Yes | [SignedAtomicAmount](/api-reference/schemas/signed-atomic-amount/) | — |
| <code>slippageImprovementPips</code> | Yes | <code>integer</code> | — |
| <code>claimRatePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>retentionPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>costPerVerifiedLiquidityDayQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>mercenaryRiskPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>recommendation</code> | Yes | [IncentiveRecommendation](/api-reference/schemas/incentive-recommendation/) | — |
| <code>baselineEvidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | — |
| <code>measurementEvidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | — |
| <code>confidenceEvidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | — |
| <code>reasons</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/IncentiveOptimization</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).