# MarketQualityScore

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>scoreVersion</code> | Yes | <code>string</code> | Allowed: <code>market-quality-score-v1</code>, <code>market-quality-score-v2</code> |
| <code>vaultId</code> | Yes | <code>string</code> | — |
| <code>capturedAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>rawMetrics</code> | No | [MarketQualityRawMetrics](/api-reference/schemas/market-quality-raw-metrics/) | — |
| <code>sourceBindings</code> | No | [MarketQualitySourceBindings](/api-reference/schemas/market-quality-source-bindings/) | — |
| <code>inputHash</code> | No | [Hash](/api-reference/schemas/hash/) | — |
| <code>availability</code> | Yes | <code>string</code> | Allowed: <code>AVAILABLE</code>, <code>UNAVAILABLE</code> |
| <code>score</code> | No | <code>integer</code> | Minimum: <code>0</code>; Maximum: <code>100</code> |
| <code>coveragePips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>components</code> | Yes | Array of <code>object</code> | — |
| <code>components&#91;&#93;.component</code> | Yes | <code>string</code> | Allowed: <code>SLIPPAGE</code>, <code>USABLE&#95;DEPTH</code>, <code>SPREAD</code>, <code>CAPITAL&#95;EFFICIENCY</code>, <code>CONCENTRATION</code>, <code>VOLATILITY&#95;RESISTANCE</code>, <code>INVENTORY&#95;RISK</code>, <code>IMBALANCE</code>, <code>PRICE&#95;RECOVERY</code>, <code>RELIABILITY</code> |
| <code>components&#91;&#93;.weightPips</code> | Yes | [Pips](/api-reference/schemas/pips/) | — |
| <code>components&#91;&#93;.score</code> | No | <code>integer</code> | Minimum: <code>0</code>; Maximum: <code>100</code> |
| <code>components&#91;&#93;.evidenceHashes</code> | Yes | Array of [Hash](/api-reference/schemas/hash/) | — |
| <code>changeDrivers</code> | Yes | Array of <code>object</code> | — |
| <code>changeDrivers&#91;&#93;.component</code> | Yes | <code>string</code> | Allowed: <code>SLIPPAGE</code>, <code>USABLE&#95;DEPTH</code>, <code>SPREAD</code>, <code>CAPITAL&#95;EFFICIENCY</code>, <code>CONCENTRATION</code>, <code>VOLATILITY&#95;RESISTANCE</code>, <code>INVENTORY&#95;RISK</code>, <code>IMBALANCE</code>, <code>PRICE&#95;RECOVERY</code>, <code>RELIABILITY</code> |
| <code>changeDrivers&#91;&#93;.delta</code> | Yes | <code>integer</code> | — |
| <code>improvements</code> | Yes | Array of <code>string</code> | — |
| <code>peerBenchmark</code> | No | <code>object</code> | Additional properties rejected |
| <code>peerBenchmark.cohortDefinition</code> | Yes | <code>string</code> | — |
| <code>peerBenchmark.cohortSize</code> | Yes | <code>integer</code> | Minimum: <code>10</code> |
| <code>peerBenchmark.percentile</code> | Yes | <code>integer</code> | Minimum: <code>0</code>; Maximum: <code>100</code> |
| <code>unavailableReason</code> | No | <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/MarketQualityScore</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).