# PublicLiquidityInvestigation

[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>public-liquidity-investigation-v1</code> | — |
| <code>question</code> | Yes | Constant <code>POOL&#95;RESERVE&#95;SCALE&#95;V1</code> | — |
| <code>investigationId</code> | Yes | <code>string</code> | Deterministic identifier for this public-source investigation; not a saved tenant record. Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>requestedQuoteSizeAtomic</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>source</code> | Yes | [PublicProjectAnalysis](/api-reference/schemas/public-project-analysis/) | — |
| <code>finding</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>finding.state</code> | Yes | <code>string</code> | Allowed: <code>AVAILABLE</code>, <code>UNAVAILABLE</code> |
| <code>finding.poolAddress</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>finding.quoteReserveAtomic</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>finding.quoteDecimals</code> | Yes | At least one of: <code>integer</code>; <code>null</code> | — |
| <code>finding.sizeToReservePips</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>finding.reason</code> | Yes | <code>string</code> | Allowed: <code>NO&#95;QUOTE&#95;SIZE</code>, <code>NO&#95;VERIFIED&#95;POOL</code>, <code>QUOTE&#95;PRECISION&#95;UNAVAILABLE</code>, <code>ZERO&#95;QUOTE&#95;RESERVE</code>, <code>SOURCE&#95;INCONSISTENT</code>, <code>VERIFIED&#95;RESERVE&#95;RATIO&#95;ONLY</code> |
| <code>limitations</code> | Yes | Array of <code>string</code> | Min items: <code>1</code>; Max items: <code>20</code> |
| <code>financialAuthority</code> | Yes | Constant <code>false</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/PublicLiquidityInvestigation</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).