# MarketMakerEvidenceObservationInput [All API schemas](/api-reference/schemas/) Exactly one of: object; object; object; object | Field | Required at this level | Type | Description and constraints | | --- | --- | --- | --- | | oneOf[1].observationId | Yes | string | — | | oneOf[1].mandateId | Yes | string | — | | oneOf[1].observedAt | Yes | string | Format: date-time | | oneOf[1].sourceReferenceHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[1].sourcePayloadHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[1].providerId | Yes | string | — | | oneOf[1].providerKeyResourceVersion | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[1].providerAttestationHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[1].signature | Yes | string | Content encoding: base64 | | oneOf[1].balances | Yes | Array of object | Min items: 1; Max items: 1000 | | oneOf[1].balances[].assetId | Yes | string | — | | oneOf[1].balances[].amountAtomic | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].balances[].valueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].capitalDeployedQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].usableDepthQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].observedSpreadPips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[1].observedUptimePips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[1].grossReturnsQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].feesPaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].returnedToken | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].returnedTokenValueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].repaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].counterpartyExposureQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].evidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: 1; Max items: 256 | | oneOf[1].sourceKind | Yes | Constant ONCHAIN_WALLET | — | | oneOf[1].chainEvidence | Yes | object | Additional properties rejected | | oneOf[1].chainEvidence.chainId | Yes | integer | Minimum: 1 | | oneOf[1].chainEvidence.chainGenesisHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[1].chainEvidence.blockNumber | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[1].chainEvidence.blockHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[1].chainEvidence.finality | Yes | Constant FINALIZED | — | | oneOf[1].chainEvidence.rpcQuorumAttestations | Yes | Array of [VenueRpcQuorumAttestation](/api-reference/schemas/venue-rpc-quorum-attestation/) | Max items: 8 | | oneOf[1].reconciliationStatus | Yes | string | Allowed: PENDING, DISPUTED | | oneOf[1].reconciliationEvidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Max items: 128 | | oneOf[2].observationId | Yes | string | — | | oneOf[2].mandateId | Yes | string | — | | oneOf[2].observedAt | Yes | string | Format: date-time | | oneOf[2].sourceReferenceHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[2].sourcePayloadHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[2].providerId | Yes | string | — | | oneOf[2].providerKeyResourceVersion | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[2].providerAttestationHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[2].signature | Yes | string | Content encoding: base64 | | oneOf[2].balances | Yes | Array of object | Min items: 1; Max items: 1000 | | oneOf[2].balances[].assetId | Yes | string | — | | oneOf[2].balances[].amountAtomic | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].balances[].valueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].capitalDeployedQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].usableDepthQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].observedSpreadPips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[2].observedUptimePips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[2].grossReturnsQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].feesPaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].returnedToken | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].returnedTokenValueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].repaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].counterpartyExposureQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].evidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: 1; Max items: 256 | | oneOf[2].sourceKind | Yes | Constant ONCHAIN_WALLET | — | | oneOf[2].chainEvidence | Yes | object | Additional properties rejected | | oneOf[2].chainEvidence.chainId | Yes | integer | Minimum: 1 | | oneOf[2].chainEvidence.chainGenesisHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[2].chainEvidence.blockNumber | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[2].chainEvidence.blockHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[2].chainEvidence.finality | Yes | Constant FINALIZED | — | | oneOf[2].chainEvidence.rpcQuorumAttestations | Yes | Array of [VenueRpcQuorumAttestation](/api-reference/schemas/venue-rpc-quorum-attestation/) | Max items: 8 | | oneOf[2].reconciliationStatus | Yes | string | Allowed: MATCHED, FINALIZED | | oneOf[2].reconciliationEvidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: 1; Max items: 128 | | oneOf[3].observationId | Yes | string | — | | oneOf[3].mandateId | Yes | string | — | | oneOf[3].observedAt | Yes | string | Format: date-time | | oneOf[3].sourceReferenceHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[3].sourcePayloadHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[3].providerId | Yes | string | — | | oneOf[3].providerKeyResourceVersion | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[3].providerAttestationHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[3].signature | Yes | string | Content encoding: base64 | | oneOf[3].balances | Yes | Array of object | Min items: 1; Max items: 1000 | | oneOf[3].balances[].assetId | Yes | string | — | | oneOf[3].balances[].amountAtomic | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].balances[].valueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].capitalDeployedQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].usableDepthQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].observedSpreadPips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[3].observedUptimePips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[3].grossReturnsQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].feesPaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].returnedToken | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].returnedTokenValueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].repaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].counterpartyExposureQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[3].evidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: 1; Max items: 256 | | oneOf[3].sourceKind | Yes | string | Allowed: SIGNED_API, SIGNED_FILE, SIGNED_EXCHANGE | | oneOf[3].reconciliationStatus | Yes | string | Allowed: PENDING, DISPUTED | | oneOf[3].reconciliationEvidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Max items: 128 | | oneOf[4].observationId | Yes | string | — | | oneOf[4].mandateId | Yes | string | — | | oneOf[4].observedAt | Yes | string | Format: date-time | | oneOf[4].sourceReferenceHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[4].sourcePayloadHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[4].providerId | Yes | string | — | | oneOf[4].providerKeyResourceVersion | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[4].providerAttestationHash | Yes | [Hash](/api-reference/schemas/hash/) | — | | oneOf[4].signature | Yes | string | Content encoding: base64 | | oneOf[4].balances | Yes | Array of object | Min items: 1; Max items: 1000 | | oneOf[4].balances[].assetId | Yes | string | — | | oneOf[4].balances[].amountAtomic | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].balances[].valueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].capitalDeployedQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].usableDepthQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].observedSpreadPips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[4].observedUptimePips | Yes | [Pips](/api-reference/schemas/pips/) | — | | oneOf[4].grossReturnsQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].feesPaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].returnedToken | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].returnedTokenValueQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].repaidQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].counterpartyExposureQuote | Yes | [AtomicAmount](/api-reference/schemas/atomic-amount/) | — | | oneOf[4].evidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: 1; Max items: 256 | | oneOf[4].sourceKind | Yes | string | Allowed: SIGNED_API, SIGNED_FILE, SIGNED_EXCHANGE | | oneOf[4].reconciliationStatus | Yes | string | Allowed: MATCHED, FINALIZED | | oneOf[4].reconciliationEvidenceHashes | Yes | Array of [Hash](/api-reference/schemas/hash/) | Min items: 1; Max items: 128 | Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema. Exact definition: #/components/schemas/MarketMakerEvidenceObservationInput in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).