# MarketDiscoveryEvidence

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

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

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>project</code> | Yes | [MarketDiscoveryProject](/api-reference/schemas/market-discovery-project/) | — |
| <code>retrievedAt</code> | Yes | <code>string</code> | Format: <code>date-time</code> |
| <code>pools</code> | Yes | Array of [MarketDiscoveryPool](/api-reference/schemas/market-discovery-pool/) | Max items: <code>500</code> |
| <code>metrics</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>metrics.priceUsd</code> | Yes | At least one of: <code>number</code>; <code>null</code> | Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof. |
| <code>metrics.liquidityUsd</code> | Yes | At least one of: <code>number</code>; <code>null</code> | Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof. |
| <code>metrics.volume24hUsd</code> | Yes | At least one of: <code>number</code>; <code>null</code> | Provider-reported approximate market figure. This is not an exact atomic balance or a finalized chain proof. |
| <code>metrics.priceChange24hPercent</code> | Yes | At least one of: <code>number</code>; <code>null</code> | — |
| <code>metrics.largestPoolSharePercent</code> | Yes | At least one of: <code>number</code>; <code>null</code> | — |
| <code>sources</code> | Yes | Array of <code>object</code> | Max items: <code>502</code> |
| <code>sources&#91;&#93;.id</code> | Yes | <code>string</code> | Min length: <code>1</code>; Max length: <code>80</code> |
| <code>sources&#91;&#93;.label</code> | Yes | <code>string</code> | Max length: <code>300</code> |
| <code>sources&#91;&#93;.url</code> | Yes | <code>string</code> | Max length: <code>2048</code> |
| <code>gaps</code> | Yes | Array of <code>string</code> | Max items: <code>32</code> |
| <code>workspace</code> | No | [WorkflowVaultContext](/api-reference/schemas/workflow-vault-context/) | — |

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/MarketDiscoveryEvidence</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).