LogoLogo
Launch App ->
  • Overview
  • Product
    • Credit Vaults
      • Tranching
      • Live vaults
    • USP
      • Allocation
      • Risks
      • FAQs
    • Users
      • Lenders
        • Verification
        • Guides
          • Onboarding
          • Deposit
          • Redeem
      • Curators
      • Borrowers
  • Developers
    • Addresses
      • Product
        • Credit Vaults
        • USP
      • Governance
    • Integrators
    • API
      • Campaigns
      • Chains
      • Operators
      • Token blocks
      • Tokens
      • Transactions
      • Vaults
      • Vault blocks
      • Vault categories
      • Vault epochs
      • Vault performances
      • Vault types
    • Security
      • Audits
  • Resources
    • Media kit
Powered by GitBook
On this page
Export as PDF
  1. Developers
  2. API

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

PreviousVault categoriesNextVault performances

Last updated 1 month ago

List all vault epochs

get
Responses
200
A list of vault epochs
application/json
get
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": "2025-05-18T22:32:19.343Z",
      "endDate": "2025-05-18T22:32:19.343Z",
      "startCureDate": "2025-05-18T22:32:19.343Z",
      "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": "2025-05-18T22:32:19.343Z",
        "disabled": true
      },
      "createdAt": "2025-05-18T22:32:19.343Z",
      "updatedAt": "2025-05-18T22:32:19.343Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
  ],
  "totalCount": 1
}
  • Structure
  • Endpoints
  • GETList all vault epochs