# IncentiveProgram

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>programId</code> | Yes | <code>string</code> | — |
| <code>venueId</code> | Yes | <code>string</code> | — |
| <code>startsAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>endsAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>incentivesPaidQuote</code> | Yes | [PositiveAtomicAmount](/api-reference/schemas/positive-atomic-amount/) | — |
| <code>claimedRewardsQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>baseline</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>baseline.baselineId</code> | Yes | <code>string</code> | — |
| <code>baseline.method</code> | Yes | <code>string</code> | Allowed: <code>PRE&#95;PROGRAM&#95;WINDOW</code>, <code>MATCHED&#95;CONTROL</code>, <code>FROZEN&#95;COUNTERFACTUAL</code> |
| <code>baseline.windowStartsAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>baseline.windowEndsAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>baseline.frozenAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>baseline.liquidityQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>baseline.volumeQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>baseline.slippagePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>baseline.evidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: <code>1</code>; Max items: <code>128</code> |
| <code>observedLiquidityQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>observedVolumeQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>observedSlippagePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>observedAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>observationEvidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: <code>1</code>; Max items: <code>128</code> |
| <code>retainedLiquidityQuote</code> | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — |
| <code>retentionObservedAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>retentionEvidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: <code>1</code>; Max items: <code>128</code> |
| <code>verifiedLiquidityDays</code> | Yes | <code>integer</code> | Minimum: <code>0</code>; Maximum: <code>36500</code> |
| <code>confidencePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>confidenceMethodology</code> | Yes | <code>string</code> | — |
| <code>confidenceEvidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: <code>1</code>; Max items: <code>128</code> |
| <code>requestedPoolId</code> | No | <code>string</code> | — |
| <code>requestedRangeId</code> | No | <code>string</code> | — |
| <code>adapterAuthorization</code> | No | <code>object</code> | Additional properties rejected |
| <code>adapterAuthorization.adapterId</code> | Yes | <code>string</code> | — |
| <code>adapterAuthorization.venueId</code> | Yes | <code>string</code> | — |
| <code>adapterAuthorization.adapterAddress</code> | Yes | [Address](/api-reference/schemas/address/) | — |
| <code>adapterAuthorization.adapterRuntimeHash</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>adapterAuthorization.auditHash</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>adapterAuthorization.adapterManifestHash</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>adapterAuthorization.releasedManifestDigest</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>adapterAuthorization.providerId</code> | Yes | <code>string</code> | — |
| <code>adapterAuthorization.providerKeyResourceVersion</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>adapterAuthorization.providerAttestationHash</code> | Yes | [Hash](/api-reference/schemas/hash/) | — |
| <code>adapterAuthorization.issuedAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>adapterAuthorization.validUntil</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>adapterAuthorization.allowedRecommendations</code> | Yes | Array of [IncentiveRecommendation](/api-reference/schemas/incentive-recommendation/) | Min items: <code>1</code>; Max items: <code>7</code> |
| <code>adapterAuthorization.signature</code> | Yes | <code>string</code> | Content encoding: <code>base64</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/IncentiveProgram</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).