Garantias

Endpoints para consulta dos cálculos de LTV (Loan-to-Value) das garantias.

Cada recálculo de LTV gera um snapshot com o retrato da garantia naquele momento: saldo devedor, colateral bruto e líquido (após haircut), limites de alerta e liquidação e o status resultante.

Status possíveis

Status	Significado
`OK`	Garantia saudável — LTV abaixo do limite de alerta
`ALERT`	LTV atingiu o limite de alerta ou colateral líquido abaixo do mínimo requerido
`RELEASE_LIQUIDATION`	LTV atingiu o limite de liquidação

Retorna os últimos snapshots de LTV de um contrato.

Query Parameters

Param	Tipo	Obrigatório	Default	Descrição
`contractId`	int > 0	sim	—	ID do contrato
`limit`	int (1–100)	não	10	Quantidade de snapshots mais recentes

RESPONSES

200Snapshots de LTV

{
  "contractId": 123,
  "count": 2,
  "snapshots": [
    {
      "contractId": "123",
      "timestamp": "2026-05-13T18:00:00.000Z",
      "trigger": "SCHEDULED_RECALC",
      "outstandingBalance": 95000,
      "grossCollateral": 150000,
      "liquidCollateral": 142500,
      "minimumGuaranteeRequired": 142500,
      "currentLtv": 0.6667,
      "collateralCoverageRatio": 1.5,
      "alertLtv": 0.75,
      "releaseLiquidationLtv": 0.85,
      "appliedHaircut": 0.05,
      "status": "OK",
      "reason": null
    },
    {
      "contractId": "123",
      "timestamp": "2026-05-13T17:00:00.000Z",
      "trigger": "SCHEDULED_RECALC",
      "outstandingBalance": 95000,
      "grossCollateral": 145000,
      "liquidCollateral": 137750,
      "minimumGuaranteeRequired": 142500,
      "currentLtv": 0.6897,
      "collateralCoverageRatio": 1.45,
      "alertLtv": 0.75,
      "releaseLiquidationLtv": 0.85,
      "appliedHaircut": 0.05,
      "status": "OK",
      "reason": null
    }
  ]
}

400contractId ausente ou inválido

401Não autenticado

Notas

contractsWithoutSnapshot conta contratos ativos que ainda não tiveram cálculo de LTV (por exemplo, garantia ainda sem depósito).
Mudanças de status da garantia também são publicadas como webhooks (collateral.ltv_alert, collateral.liquidated — ver Guia de Webhooks).