Vault epochs

Vault epochs define fixed-duration accounting periods used in vault logic to compute returns, manage liquidity flows, and determine claim availability.

Structure

Each vault epoch object includes:

• _id (string) — Unique identifier

• vaultId (string) — Vault the epoch belongs to

• vaultAddress (string) — Address of the vault

• block (object) —

  • number (number) — Block number

  • timestamp (number) — Unix timestamp

• count (number) — Epoch sequence index

• status (string) — One of: WAITING, RUNNING, DEFAULTED, CURE

• startDate (string) — ISO 8601 start date

• endDate (string) — ISO 8601 end date

• startCureDate (string) — When cure phase begins (if applicable)

• apr (number) — Estimated APR

• lastApr (number) — APR from previous epoch

• expectedInterest (string) — Interest forecasted during this epoch

• unclaimedFees (string) — Fees not yet claimed

• deposits (string) — Total deposits in epoch

• duration (number) — Duration in seconds

• bufferDuration (number) — Buffer window after epoch ends

• withdrawType (string) — Either INSTANT or STANDARD

• withdraws (object) —

  • amount (string)

  • fees (string)

• depositQueue (object) —

  • amount (string)

  • lastAmount (string)

  • isInstant (boolean)

• withdrawQueue (object) —

  • amount (string)

  • lastAmount (string)

  • isInstant (boolean)

• instantWithdraws (object) —

  • allowed (boolean)

  • delay (number)

  • amount (string)

  • aprDelta (number)

  • deadline (string) — ISO 8601 date

  • disabled (boolean)

• createdAt, updatedAt (string) — ISO 8601 timestamps

• createdBy, updatedBy (string) — Actor IDs

Endpoints

List all vault epochs

get

Responses

200

A list of vault epochs

application/json

totalCountintegerOptional

get/vault-epochs

HTTPcURLJavaScriptPython

GET /v1/vault-epochs HTTP/1.1
Host: api.pareto.credit
Accept: */*

200

A list of vault epochs

{
  "data": [
    {
      "_id": "text",
      "vaultId": "text",
      "vaultAddress": "text",
      "block": {
        "number": 1,
        "timestamp": 1
      },
      "count": 1,
      "status": "WAITING",
      "startDate": "2026-07-14T21:39:31.798Z",
      "endDate": "2026-07-14T21:39:31.798Z",
      "startCureDate": "2026-07-14T21:39:31.798Z",
      "apr": 1,
      "lastApr": 1,
      "expectedInterest": "text",
      "unclaimedFees": "text",
      "deposits": "text",
      "duration": 1,
      "bufferDuration": 1,
      "withdrawType": "INSTANT",
      "withdraws": {
        "amount": "text",
        "fees": "text"
      },
      "depositQueue": {
        "amount": "text",
        "lastAmount": "text",
        "isInstant": true
      },
      "withdrawQueue": {
        "amount": "text",
        "lastAmount": "text",
        "isInstant": true
      },
      "instantWithdraws": {
        "allowed": true,
        "delay": 1,
        "amount": "text",
        "aprDelta": 1,
        "deadline": "2026-07-14T21:39:31.798Z",
        "disabled": true
      },
      "createdAt": "2026-07-14T21:39:31.798Z",
      "updatedAt": "2026-07-14T21:39:31.798Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
  ],
  "totalCount": 1
}