All pages
Powered by GitBook
1 of 13

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Chains

Chains represent the supported blockchain networks that Pareto interacts with. These include the networks where vaults are deployed, where user interactions occur, and where transactions are tracked.

Structure

Each chain object includes:

  • _id (string) — Unique identifier for the chain

  • name (string) — Human-readable name of the blockchain (e.g., "Ethereum")

  • chainId (string) — Network ID used internally by Pareto

  • nativeToken (string) — Symbol of the native currency (e.g., ETH, MATIC)

  • explorerUrl (string) — Block explorer base URL for linking transactions or accounts

  • icon (string) — Optional icon URL

  • createdAt, updatedAt (string) — ISO timestamps (UTC Unix time)

Endpoints

Campaigns

Campaigns are point-based programs used to incentivize user activities on Pareto. Users can earn points by interacting with vaults or participating in social activities.

Structure

Each campaign object includes:

  • _id (string) — Unique identifier

  • code (string) — Campaign code

  • name (object) — Multilingual name, e.g. { en: "My Campaign" }

  • description (object) — Multilingual description

  • rules (array) — Conditions for earning points:

    • name, description (object) — i18n fields

    • trigger (string) — DEPOSIT

  • referrals (array) — Invite codes with activation flag

  • startDate / endDate (string) — ISO datetime

  • link (string) — URL

  • galxeId (number) — External reference

  • createdAt, updatedAt (string) — ISO timestamp

  • createdBy, updatedBy (string) — Actor IDs

Endpoints

API

Pareto APIs provide access to campaign data, vault analytics, token information, and third-party integrated services.

This is the active major version v1 of the API. All endpoints listed are part of the v1 namespace.

Quick start

  1. Request an API key via this form. Once approved, you will receive a key for authentication

  2. Use your preferred HTTP client (e.g., Postman, Axios, cURL)

  3. Add your API key as a Bearer Token in the Authorization header

  4. Start by fetching vaults or campaign data:

Endpoints

A campaign is a points-based engagement program that allows users to earn rewards by interacting with Pareto.

  • GET /v1/campaigns — List all campaigns

  • GET /v1/campaigns/:campaignId — Get campaign by ID

  • GET /v1/campaigns/:campaignId/points — Get campaign points

  • GET /v1/chains — List supported chains

  • GET /v1/chains/:chainId — Get chain by ID

An entity managing or integrating with Pareto products.

  • GET /v1/operators — List all operators

  • GET /v1/operators/:operatorId — Get operator by ID

  • GET /v1/token-blocks — List all token blocks

  • GET /v1/token-blocks/:tokenBlockId — Get token block by ID

  • GET /v1/tokens — List all tokens

  • GET /v1/tokens/:tokenId — Get token by ID

  • GET /v1/transactions — List all protocol transactions

A yield-generating smart contract product.

  • GET /v1/vaults — List all vaults

  • GET /v1/vaults/:vaultId — Get vault by ID

  • GET /v1/vaults/performances — Vault performance overview

  • GET /v1/vault-blocks — List all vault blocks

  • GET /v1/vault-blocks/:vaultBlockId — Get vault block by ID

  • GET /v1/vault-latest-blocks — Latest block data for vaults

  • GET /v1/vault-categories — List all vault categories

  • GET /v1/vault-categories/:typeId — Get category by ID

A predefined period for vault accounting.

  • GET /v1/vault-epochs — List all vault epochs

  • GET /v1/vault-performances — List all performance metrics

  • GET /v1/vault-performances/:vaultPerformanceId — Get performance by ID

  • GET /v1/vault-types — List all vault types

  • GET /v1/vault-types/:typeId — Get vault type by ID

Listing

All listing endpoints across the API (e.g., /vaults, /transactions, /tokens, etc.) follow a consistent response format in consuming paginated data throughout the API:

  • data: an array of returned resources.

  • totalCount: the total number of resources matching the query, useful for pagination.

Pagination, sorting, fields

To control the number of items returned per request, you can use:

  • limit — Number of items to return (default: 50, max: 200)

  • offset — Number of items to skip before starting to collect the result set

The sort query parameter allows you to sort results by one or more fields:

  • Use field for ascending order

  • Use -field for descending order

Some endpoints support the fields parameter, which lets you request only specific fields per object:

This can be useful for optimizing network performance and response size.

Base URL
https://api.pareto.credit/
GET /v1/vaults/:vaultId/integrations — Integrations by vault ID
Campaigns
Chains
Operators
Token blocks
Tokens
Transactions
Vaults
Vault blocks
Vault categories
Vault epochs
Vault performances
Vault types
curl -H "Authorization: Bearer YOUR_API_KEY" https://api.pareto.credit/v1/vaults
{
  "data": [ /* items */ ],
  "totalCount": 123
}
GET /v1/vaults?limit=10&offset=20
GET /v1/vaults?sort=-createdAt
GET /v1/vaults?fields=_id,name,createdAt
or
DEPOSIT_REQUEST
  • deposit (object) —

    • type: BALANCE or AGE

    • value: number

  • reward (object) —

    • type: AMOUNT or MULTIPLIER

    • value: number

  • frequency (object) — repetition rules (value, unit)

  • Tokens

    Tokens are ERC-20 compatible assets used in vaults and tracked by the Pareto protocol across multiple chains.

    Structure

    Each token object includes:

    • _id (string) — Unique identifier

    • name (string) — Name of the token

    • symbol (string) — Token symbol (e.g. USDC, WETH)

    • chainId (string) — Chain this token belongs to

    • address (string) — On-chain contract address (0x...)

    • decimals (number) — Token decimal precision

    • color (string) — UI color reference for this token

    • oracle (object) — Price oracle metadata:

      • address (string) — Oracle contract address

      • abi (array) — Oracle ABI definition

    • createdAt, updatedAt (string) — ISO timestamps

    • createdBy, updatedBy (string) — System actor IDs

    Endpoints

    Vault performances

    Vault performances track yield metrics, user activity, and reward distributions for vaults. These metrics are used in analytics, reporting, and performance visualization on Pareto.

    Structure

    Each vault performance object includes:

    • _id (string) — Unique identifier

    • vaultId (string) — Vault being tracked

    • vaultBlockId (string) — Related vault block reference

    • block (object) — Block information:

      • number (number) — Block number

      • timestamp (number) — Unix timestamp

    • age (number) — Block age in seconds

    • holders (number) — Number of unique users in the vault

    • realizedAPY (number) — Realized annual percentage yield

    • accruedRewards (array of objects) —

      • tokenId (string) — Reward token ID

      • amount (string) — Raw amount of rewards

    • earnings (object) —

      • USD (string) — USD-denominated earnings

      • token (string) — Token earnings amount

    • createdAt, updatedAt (string) — ISO 8601 timestamps

    • createdBy, updatedBy (string) — Actor IDs

    Endpoints

    Transactions

    Transactions represent user and system interactions with Pareto vaults such as deposits, redemptions, and claims.

    Structure

    Each transaction object includes:

    • _id (string) — Unique identifier

    Vault types

    Vault types define internal classifications for vault contracts, distinguishing between different logic structures, yield mechanisms, or operational modes. These types are useful for rendering vault metadata, sorting/filtering in UI, or determining strategy compatibility.

    Structure

    Each vault type object includes:

    • _id (string) — Unique identifier

    protocol (string) — Data source (e.g., Idle, AaveV2, Morpho, Clearpool)

  • fee (number, optional) — Optional oracle fee

  • Additional optional config fields (e.g. fromBlock, USDCAddress, ...)

  • amountUSD (string) — Value in USD

  • APR (number) — APR contribution

  • percentage (number) — Share of total reward

  • percentage (number) — Share of vault value

    type (string) — One of: DEPOSIT, REDEEM, CLAIM

  • status (string) — One of: PENDING, SUCCESS, FAILED

  • hash (string) — Transaction hash on-chain

  • chainId (string) — Blockchain ID where the transaction occurred

  • walletAddress (string) — Wallet initiating the transaction

  • vaultId (string) — Associated vault

  • epochId (string) — Related epoch (if applicable)

  • tokenId (string) — Token involved

  • amount (string) — Amount transacted

  • amountUSD (string) — USD equivalent of the transaction

  • gasFeeUSD (string) — Gas fee in USD

  • block: (object)

    • number (number) — Block number

    • timestamp (number) — Unix timestamp of the block

  • createdAt, updatedAt (string) — ISO timestamps

  • createdBy, updatedBy (string) — Actor identifiers

  • Endpoints

  • code (string) — Internal reference code for the vault type

  • name (object) — Multilingual object (e.g., { en: "Fixed Rate" })

  • description (object) — Multilingual description object

  • createdAt, updatedAt (string) — ISO UTC timestamps

  • createdBy, updatedBy (string) — Actor IDs

  • Endpoints

    Token blocks

    Token blocks are periodic snapshots of token-related data captured at specific blockchain blocks. These are used in vault logic and on-chain analytics.

    Structure

    Each token block object includes:

    • _id (string) — Unique identifier

    • tokenId (string) — ID of the associated token

    • tokenAddress (string) — Ethereum address of the token (0x... format)

    • price (string) — Price of the token at this block

    • block (object) —

      • number (number) — Block number

      • timestamp (number) — Unix timestamp (UTC)

    • createdAt, updatedAt (string) — ISO timestamps

    • createdBy, updatedBy (string) — Actor IDs

    Vault categories

    Vault categories group vaults by their investment profile, strategy type, or risk classification. They provide high-level metadata for sorting and UI filtering.

    Structure

    Each vault category object includes:

    • _id (string) — Unique identifier

    • code (string) — Unique category code (e.g. "CAT_1", "STRATEGY")

    • name (object) — Multilingual name (e.g., { en: "Stable Yield" })

    • description (object) — Multilingual description

    • createdAt, updatedAt (string) — ISO timestamps (UTC Unix time)

    • createdBy, updatedBy (string) — Actor IDs

    Endpoints

    Vaults

    Vaults are the core contracts of the Pareto protocol. They represent on-chain vehicles that accept user deposits, deploy strategies, and accrue yield over time.

    Each vault is tied to a specific strategy, chain, and token, and is managed by one or more operators.

    Structure

    Each vault object includes:

    • _id (string) — Unique identifier

    • tokenId (string) — Accepted token reference

    • chainId (string) — Blockchain network identifier

    • typeId (string) — Reference to vault type

    • categoryId (string) — Vault category

    • operatorIds (array[string]) — Managing entities

    • name (string) — Name of the vault

    • address (string) — On-chain vault contract address

    • symbol (string) — Symbol of the share token

    • protocol (string) — Strategy protocol (e.g., AaveV2, Clearpool, Morpho, etc.)

    • contractType (string) — Contract logic (e.g., BestYield, CDO, CDO_EPOCH)

    • abi (array) — ABI definition

    • description, shortDescription, caption (object) — Multilingual metadata

    • keyInfo (array) — Key-value UI information

    • visibility (string) — One of: PUBLIC, RESTRICTED, HIDDEN

    • status (string) — Deployment status (e.g., READY, PAUSED, DISABLED)

    • feePercentage (number) — Vault fee as percentage

    • createdAt, updatedAt (string) — ISO timestamps

    • createdBy, updatedBy (string) — System actor IDs

    Endpoints

    Operators

    Operators represent key entities that interact with the Pareto protocol. These can be protocol partners, borrowers, or curators responsible for deploying or managing vaults.

    Structure

    Each operator object includes:

    • _id (string) — Unique identifier

    • name (string) — Name of the operator

    • code (string) — Unique internal code

    • type (string) — One of: PROTOCOL, BORROWER, CURATOR

    • description (object) — Multilingual description (e.g. { en: "This is a protocol operator" })

    • shortDescription (object) — Short version of the description

    • caption (object) — Promotional caption

    • rating (string) — Internal rating indicator

    • location (string) — Geographic reference

    • links (object) —

      • website (string)

      • twitter (string)

    • createdAt, updatedAt (string) — ISO timestamps (UTC Unix time)

    • createdBy, updatedBy (string) — Actor IDs for auditing

    Endpoints

    linkedIn (string)

  • crunchbase (string)

  • 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)

    • allocations (array) — Optional pool allocation breakdown

    • createdAt, updatedAt (string) — ISO timestamps

    • createdBy, updatedBy (string) — Actor IDs

    Endpoints

    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

    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

    List all campaigns

    get
    Responses
    200

    A list of campaigns

    application/json

    Get campaign by ID

    get
    Path parameters
    campaignIdstringRequired
    Responses
    200

    Campaign details

    application/json
    get
    /campaigns/{campaignId}
    get
    /campaigns
    200

    A list of campaigns

    200

    Campaign details

    GET /v1/campaigns HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "code": "text",
          "name": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "description": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "rules": [
            {
              "name": {
                "ANY_ADDITIONAL_PROPERTY": "text"
              },
              "description": {
                "ANY_ADDITIONAL_PROPERTY": "text"
              },
              "trigger": "DEPOSIT",
              "deposit": {
                "type": "BALANCE",
                "value": 1
              },
              "reward": {
                "type": "AMOUNT",
                "value": 1
              },
              "frequency": {
                "value": 1,
                "unit": "seconds"
              }
            }
          ],
          "referrals": [
            {
              "code": "text",
              "isActive": true
            }
          ],
          "startDate": "2025-12-08T23:45:18.371Z",
          "endDate": "2025-12-08T23:45:18.371Z",
          "link": "text",
          "galxeId": 1,
          "createdAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "code": "text",
      "name": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "description": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "rules": [
        {
          "name": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "description": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "trigger": "DEPOSIT",
          "deposit": {
            "type": "BALANCE",
            "value": 1
          },
          "reward": {
            "type": "AMOUNT",
            "value": 1
          },
          "frequency": {
            "value": 1,
            "unit": "seconds"
          }
        }
      ],
      "referrals": [
        {
          "code": "text",
          "isActive": true
        }
      ],
      "startDate": "2025-12-08T23:45:18.371Z",
      "endDate": "2025-12-08T23:45:18.371Z",
      "link": "text",
      "galxeId": 1,
      "createdAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "updatedBy": "text"
    }
    GET /v1/campaigns/{campaignId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    

    rates: { supply: number, borrow: number }

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

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

  • 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 transactions

    get
    Query parameters
    typestringOptional
    statusstringOptional
    walletAddressstringOptional
    vaultIdstringOptional
    chainIdstringOptional
    Responses
    200

    A list of transactions

    application/json
    get
    /transactions
    200

    A list of transactions

    List all vault types

    get
    Responses
    200

    A list of vault types

    application/json
    get
    /vault-types
    200

    A list of vault types

    Get vault type by ID

    get
    Path parameters
    typeIdstringRequired
    Responses
    200

    A single vault type

    application/json
    get
    /vault-types/{typeId}
    200

    A single vault type

    List all chains

    get
    Responses
    200

    A list of chains

    application/json
    get
    /chains
    200

    A list of chains

    Get chain by ID

    get
    Path parameters
    chainIdstringRequired
    Responses
    200

    Chain details

    application/json
    get
    /chains/{chainId}
    200

    Chain details

    List all vault performance entries

    get
    Responses
    200

    Vault performance data

    application/json
    get
    /vault-performances
    200

    Vault performance data

    Get vault performance by ID

    get
    Path parameters
    vaultPerformanceIdstringRequired
    Responses
    200

    Vault performance entry

    application/json
    get
    /vault-performances/{vaultPerformanceId}
    200

    Vault performance entry

    List all tokens

    get
    Responses
    200

    A list of tokens

    application/json
    get
    /tokens
    200

    A list of tokens

    Get token by ID

    get
    Path parameters
    tokenIdstringRequired
    Responses
    200

    Token details

    application/json
    get
    /tokens/{tokenId}
    200

    Token details

    List all token blocks

    get
    Responses
    200

    A list of token blocks

    application/json
    get
    /token-blocks

    Get token block by ID

    get
    Path parameters
    tokenBlockIdstringRequired
    Responses
    200

    Token block details

    application/json
    get
    /token-blocks/{tokenBlockId}

    List all vault categories

    get
    Responses
    200

    A list of vault categories

    application/json
    get
    /vault-categories

    Get vault category by ID

    get
    Path parameters
    typeIdstringRequired
    Responses
    200

    Vault category details

    application/json
    get
    /vault-categories/{typeId}

    List all vaults

    get
    Responses
    200

    A list of vaults

    application/json

    Get vault by ID

    get
    Path parameters
    vaultIdstringRequired
    Responses
    200

    Single vault object

    application/json
    get
    /vaults/{vaultId}

    Aggregated vault performance list

    get
    Responses
    200

    Vaults performance metrics

    application/json
    get
    /vaults/performances

    Get integrations related to a vault

    get
    Path parameters
    vaultIdstringRequired
    Responses
    200

    Integration data

    application/json
    get
    /vaults/{vaultId}/integrations
    GET /v1/vault-types HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/vault-types/{typeId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/chains HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/chains/{chainId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/tokens HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/tokens/{tokenId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    200

    A list of token blocks

    200

    Token block details

    200

    A list of vault categories

    200

    Vault category details

    get
    /vaults
    200

    A list of vaults

    200

    Single vault object

    200

    Vaults performance metrics

    200

    Integration data

    GET /v1/transactions HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "type": "DEPOSIT",
          "status": "PENDING",
          "hash": "text",
          "chainId": "text",
          "walletAddress": "text",
          "vaultId": "text",
          "epochId": "text",
          "tokenId": "text",
          "amount": "text",
          "amountUSD": "text",
          "gasFeeUSD": "text",
          "block": {
            "number": 1,
            "timestamp": 1
          },
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "data": [
        {
          "_id": "text",
          "code": "text",
          "name": {
            "en": "text"
          },
          "description": {
            "en": "text"
          },
          "createdAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "code": "text",
      "name": {
        "en": "text"
      },
      "description": {
        "en": "text"
      },
      "createdAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "updatedBy": "text"
    }
    {
      "data": [
        {
          "_id": "text",
          "name": "text",
          "hex": "text",
          "blocksPerYear": 1,
          "tokenSymbol": "text",
          "chainID": 1,
          "RPCs": [
            {
              "provider": "INFURA",
              "https": "text",
              "wss": "text",
              "name": "text",
              "isPublic": true
            }
          ],
          "color": "text",
          "isDisabled": true,
          "createdAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "name": "text",
      "hex": "text",
      "blocksPerYear": 1,
      "tokenSymbol": "text",
      "chainID": 1,
      "RPCs": [
        {
          "provider": "INFURA",
          "https": "text",
          "wss": "text",
          "name": "text",
          "isPublic": true
        }
      ],
      "color": "text",
      "isDisabled": true,
      "createdAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "updatedBy": "text"
    }
    GET /v1/vault-performances HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "vaultId": "text",
          "vaultBlockId": "text",
          "block": {
            "number": 1,
            "timestamp": 1
          },
          "age": 1,
          "holders": 1,
          "realizedAPY": 1,
          "accruedRewards": [
            {
              "tokenId": "text",
              "amount": "text",
              "amountUSD": "text",
              "APR": 1,
              "percentage": 1
            }
          ],
          "earnings": {
            "USD": "text",
            "token": "text",
            "percentage": 1
          },
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    GET /v1/vault-performances/{vaultPerformanceId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "_id": "text",
      "vaultId": "text",
      "vaultBlockId": "text",
      "block": {
        "number": 1,
        "timestamp": 1
      },
      "age": 1,
      "holders": 1,
      "realizedAPY": 1,
      "accruedRewards": [
        {
          "tokenId": "text",
          "amount": "text",
          "amountUSD": "text",
          "APR": 1,
          "percentage": 1
        }
      ],
      "earnings": {
        "USD": "text",
        "token": "text",
        "percentage": 1
      },
      "createdAt": "2025-12-08T23:45:18.371Z",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
    {
      "data": [
        {
          "_id": "text",
          "name": "text",
          "symbol": "text",
          "decimals": 1,
          "address": "text",
          "chainId": "text",
          "logoURI": "text",
          "underlying": true,
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "name": "text",
      "symbol": "text",
      "decimals": 1,
      "address": "text",
      "chainId": "text",
      "logoURI": "text",
      "underlying": true,
      "createdAt": "2025-12-08T23:45:18.371Z",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
    {
      "data": [
        {
          "_id": "text",
          "tokenId": "text",
          "chainId": "text",
          "blockNumber": 1,
          "price": 1,
          "liquidity": 1,
          "volume": 1,
          "timestamp": "2025-12-08T23:45:18.371Z",
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "tokenId": "text",
      "chainId": "text",
      "blockNumber": 1,
      "price": 1,
      "liquidity": 1,
      "volume": 1,
      "timestamp": "2025-12-08T23:45:18.371Z",
      "createdAt": "2025-12-08T23:45:18.371Z",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
    GET /v1/token-blocks HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/token-blocks/{tokenBlockId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "typeId": "text",
          "name": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "description": {
            "ANY_ADDITIONAL_PROPERTY": "text"
          },
          "icon": "text",
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "typeId": "text",
      "name": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "description": {
        "ANY_ADDITIONAL_PROPERTY": "text"
      },
      "icon": "text",
      "createdAt": "2025-12-08T23:45:18.371Z",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
    GET /v1/vault-categories HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/vault-categories/{typeId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/vaults HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "tokenId": "text",
          "chainId": "text",
          "typeId": "text",
          "categoryId": "text",
          "operatorIds": [
            "text"
          ],
          "name": "text",
          "address": "text",
          "symbol": "text",
          "protocol": "Idle",
          "contractType": "BestYield",
          "abi": [
            {}
          ],
          "description": {
            "en": "text"
          },
          "shortDescription": {
            "en": "text"
          },
          "caption": {
            "en": "text"
          },
          "keyInfo": [
            {
              "label": {
                "en": "text"
              },
              "value": {
                "en": "text"
              }
            }
          ],
          "visibility": "HIDDEN",
          "status": "PAUSED",
          "feePercentage": 1,
          "createdAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "tokenId": "text",
      "chainId": "text",
      "typeId": "text",
      "categoryId": "text",
      "operatorIds": [
        "text"
      ],
      "name": "text",
      "address": "text",
      "symbol": "text",
      "protocol": "Idle",
      "contractType": "BestYield",
      "abi": [
        {}
      ],
      "description": {
        "en": "text"
      },
      "shortDescription": {
        "en": "text"
      },
      "caption": {
        "en": "text"
      },
      "keyInfo": [
        {
          "label": {
            "en": "text"
          },
          "value": {
            "en": "text"
          }
        }
      ],
      "visibility": "HIDDEN",
      "status": "PAUSED",
      "feePercentage": 1,
      "createdAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "updatedBy": "text"
    }
    {
      "data": [
        {}
      ],
      "totalCount": 1
    }
    {
      "ANY_ADDITIONAL_PROPERTY": "anything"
    }
    GET /v1/vaults/{vaultId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/vaults/performances HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/vaults/{vaultId}/integrations HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    

    List all vault epochs

    get
    Responses
    200

    A list of vault epochs

    application/json
    get
    /vault-epochs
    200

    A list of vault epochs

    List all vault blocks

    get
    Responses
    200

    A list of vault blocks

    application/json

    Get vault block by ID

    get
    Path parameters
    vaultBlockIdstringRequired
    Responses
    200

    Vault block details

    application/json
    get
    /vault-blocks/{vaultBlockId}

    List the latest block snapshot per vault

    get
    Responses
    200

    Latest vault state per block

    application/json
    get
    /vault-latest-blocks
    get
    /vault-blocks
    200

    A list of vault blocks

    200

    Vault block details

    200

    Latest vault state per block

    GET /v1/vault-epochs HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "vaultId": "text",
          "vaultAddress": "text",
          "block": {
            "number": 1,
            "timestamp": 1
          },
          "count": 1,
          "status": "WAITING",
          "startDate": "2025-12-08T23:45:18.371Z",
          "endDate": "2025-12-08T23:45:18.371Z",
          "startCureDate": "2025-12-08T23:45:18.371Z",
          "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-12-08T23:45:18.371Z",
            "disabled": true
          },
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    GET /v1/vault-blocks HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "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-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_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-12-08T23:45:18.371Z",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedBy": "text"
    }
    {
      "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-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    GET /v1/vault-blocks/{vaultBlockId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/vault-latest-blocks HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    

    List all operators

    get
    Responses
    200

    A list of operators

    application/json
    get
    /operators
    200

    A list of operators

    Get operator by ID

    get
    Path parameters
    operatorIdstringRequired
    Responses
    200

    Operator details

    application/json
    get
    /operators/{operatorId}
    200

    Operator details

    GET /v1/operators HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    GET /v1/operators/{operatorId} HTTP/1.1
    Host: api.pareto.credit
    Accept: */*
    
    {
      "data": [
        {
          "_id": "text",
          "name": "text",
          "description": "text",
          "image": "text",
          "vaults": [
            "text"
          ],
          "createdAt": "2025-12-08T23:45:18.371Z",
          "updatedAt": "2025-12-08T23:45:18.371Z",
          "createdBy": "text",
          "updatedBy": "text"
        }
      ],
      "totalCount": 1
    }
    {
      "_id": "text",
      "name": "text",
      "description": "text",
      "image": "text",
      "vaults": [
        "text"
      ],
      "createdAt": "2025-12-08T23:45:18.371Z",
      "updatedAt": "2025-12-08T23:45:18.371Z",
      "createdBy": "text",
      "updatedBy": "text"
    }