Launch App ->

Vault blocks

Vault blocks are detailed blockchain-based snapshots of a vault’s state at a specific block height. They are used for calculating APR/APY, tracking liquidity, and generating analytics.

Structure

Each vault block object includes:

  • _id (string) — Unique identifier

  • vaultId (string) — Vault being tracked

  • vaultAddress (string) — Smart contract address of the vault

  • block (object):

    • number (number) — Block number

    • timestamp (number) — Unix timestamp of the block

  • APRs (object) — Non-compounded APRs:

    • BASE, HARVEST, REWARDS, GROSS, NET, FEE (number)

  • APYs (object) — Compounded yield rates:

    • BASE, HARVEST, REWARDS, GROSS, NET, FEE (number)

  • totalSupply (string) — Total shares issued by the vault

  • price (string) — Price per share

  • TVL (object) —

    • token (string) — TVL in vault token

    • USD (string) — TVL in USD

  • pools (array of objects) — Breakdown of pool-level performance:

    • address (string)

    • protocol (string)

    • rates: { supply: number, borrow: number }

    • utilization: { supplied: string, borrowed: string, rate: number }

    • available: { toBorrow: string, toWithDraw: string }

  • allocations (array) — Optional pool allocation breakdown

  • createdAt, updatedAt (string) — ISO timestamps

  • createdBy, updatedBy (string) — Actor IDs

Endpoints

List all vault blocks

get
Responses
200
A list of vault blocks
application/json
get
GET /v1/vault-blocks HTTP/1.1
Host: api.pareto.credit
Accept: */*
200

A list of vault blocks

{
  "data": [
    {
      "_id": "text",
      "vaultId": "text",
      "vaultAddress": "text",
      "block": {
        "number": 1,
        "timestamp": 1
      },
      "APRs": {
        "BASE": 1,
        "HARVEST": 1,
        "REWARDS": 1,
        "GROSS": 1,
        "NET": 1,
        "FEE": 1
      },
      "APYs": {
        "BASE": 1,
        "HARVEST": 1,
        "REWARDS": 1,
        "GROSS": 1,
        "NET": 1,
        "FEE": 1
      },
      "totalSupply": "text",
      "price": "text",
      "TVL": {
        "token": "text",
        "USD": "text"
      },
      "pools": [
        {
          "address": "text",
          "protocol": "text",
          "rates": {
            "supply": 1,
            "borrow": 1
          },
          "utilization": {
            "supplied": "text",
            "borrowed": "text",
            "rate": 1
          },
          "available": {
            "toBorrow": "text",
            "toWithDraw": "text"
          }
        }
      ],
      "allocations": [],
      "createdAt": "2025-07-02T00:02:53.010Z",
      "updatedAt": "2025-07-02T00:02:53.010Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
  ],
  "totalCount": 1
}

Get vault block by ID

get
Path parameters
vaultBlockIdstringRequired
Responses
200
Vault block details
application/json
get
GET /v1/vault-blocks/{vaultBlockId} HTTP/1.1
Host: api.pareto.credit
Accept: */*
200

Vault block details

{
  "_id": "text",
  "vaultId": "text",
  "vaultAddress": "text",
  "block": {
    "number": 1,
    "timestamp": 1
  },
  "APRs": {
    "BASE": 1,
    "HARVEST": 1,
    "REWARDS": 1,
    "GROSS": 1,
    "NET": 1,
    "FEE": 1
  },
  "APYs": {
    "BASE": 1,
    "HARVEST": 1,
    "REWARDS": 1,
    "GROSS": 1,
    "NET": 1,
    "FEE": 1
  },
  "totalSupply": "text",
  "price": "text",
  "TVL": {
    "token": "text",
    "USD": "text"
  },
  "pools": [
    {
      "address": "text",
      "protocol": "text",
      "rates": {
        "supply": 1,
        "borrow": 1
      },
      "utilization": {
        "supplied": "text",
        "borrowed": "text",
        "rate": 1
      },
      "available": {
        "toBorrow": "text",
        "toWithDraw": "text"
      }
    }
  ],
  "allocations": [],
  "createdAt": "2025-07-02T00:02:53.010Z",
  "updatedAt": "2025-07-02T00:02:53.010Z",
  "createdBy": "text",
  "updatedBy": "text"
}

Vault latest blocks

Vault latest blocks are real-time snapshots of the most recent state for each vault. Unlike vault blocks (historical), these represent the current or latest available data.

Endpoints

List the latest block snapshot per vault

get
Responses
200
Latest vault state per block
application/json
get
GET /v1/vault-latest-blocks HTTP/1.1
Host: api.pareto.credit
Accept: */*
200

Latest vault state per block

{
  "data": [
    {
      "vaultId": "text",
      "vaultAddress": "text",
      "block": {
        "number": 1,
        "timestamp": 1
      },
      "TVL": {
        "token": "text",
        "USD": "text"
      },
      "price": "text",
      "APRs": {
        "BASE": 1,
        "HARVEST": 1,
        "REWARDS": 1,
        "GROSS": 1,
        "NET": 1,
        "FEE": 1
      },
      "createdAt": "2025-07-02T00:02:53.010Z",
      "updatedAt": "2025-07-02T00:02:53.010Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
  ],
  "totalCount": 1
}
PreviousVaultsNextVault categories

Last updated