Vault History

get

Get APY history for all vaults for the given date range. apy is the composition-weighted yield APY (liquid assets are excluded from the APY denominator). navApy is the price-delta (NAV-based) APY computed from vault token price changes.

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

orderstring · enumOptional

Ordering for history arrays. desc returns newest first. asc returns oldest first.

Default: descExample: descPossible values:

chainIdnumber · nullableOptional

Optional chain ID. Defaults to Plume: 98866

Default: 98866

Responses

200

Vault APY history with composition and NAV-based APY

application/json

get

/vaults/apy-history

HTTPcURLJavaScriptPython

GET /v1/vaults/apy-history HTTP/1.1
Host: api.nest.credit
Accept: */*

200

Vault APY history with composition and NAV-based APY

{
  "data": [
    {
      "vaultAddress": "text",
      "history": [
        {
          "day": 1,
          "apy": {
            "rolling7d": 1,
            "rolling30d": 1,
            "sec30d": 1
          },
          "navApy": {
            "rolling7d": 1,
            "rolling30d": 1,
            "sec30d": 1
          }
        }
      ],
      "errors": [
        {
          "source": "superstate",
          "operation": "getPendingTransactions",
          "message": "superstate getPendingTransactions timed out after 10000ms",
          "code": "TIMEOUT",
          "timestamp": 1704067200
        }
      ]
    }
  ]
}

get

Get TVL history for all vaults for the given date range

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

Responses

200

VaultTVLHistory for all vaults

application/json

500

Server error

application/json

get

/vaults/tvl-history

HTTPcURLJavaScriptPython

GET /v1/vaults/tvl-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": [
    {
      "vaultAddress": "text",
      "history": [
        {
          "day": 1,
          "tvl": 1
        }
      ]
    }
  ]
}

get

Get VaultHoldersHistory for all vaults for the given date range

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

Responses

200

VaultHoldersHistory for all vaults for the given date range

application/json

500

Server error

application/json

get

/vaults/holders-history

HTTPcURLJavaScriptPython

GET /v1/vaults/holders-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": [
    {
      "vaultAddress": "text",
      "history": [
        {
          "day": 1,
          "chainId": 1,
          "start": 1,
          "end": 1,
          "min": 1,
          "max": 1,
          "average": 1,
          "count": 1
        }
      ]
    }
  ]
}

get

Get daily volume history for all vaults for the given date range

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

Responses

200

Daily volume history for all vaults for the given date range

application/json

500

Server error

application/json

get

/vaults/volume-history

HTTPcURLJavaScriptPython

GET /v1/vaults/volume-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": [
    {
      "vaultAddress": "text",
      "history": [
        {
          "day": 1,
          "volume24h": 1
        }
      ]
    }
  ]
}

get

Get APY history for vault by slug for the given date range. apy is the composition-weighted yield APY (liquid assets are excluded from the APY denominator). navApy is the price-delta (NAV-based) APY computed from vault token price changes.

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

orderstring · enumOptional

Ordering for history arrays. desc returns newest first. asc returns oldest first.

Default: descExample: descPossible values:

chainIdnumber · nullableOptional

Optional chain ID. Defaults to Plume: 98866

Default: 98866

Responses

200

Vault APY history with composition and NAV-based APY

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/apy-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/apy-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "apy": {
          "rolling7d": 1,
          "rolling30d": 1,
          "sec30d": 1
        },
        "navApy": {
          "rolling7d": 1,
          "rolling30d": 1,
          "sec30d": 1
        }
      }
    ],
    "errors": [
      {
        "source": "superstate",
        "operation": "getPendingTransactions",
        "message": "superstate getPendingTransactions timed out after 10000ms",
        "code": "TIMEOUT",
        "timestamp": 1704067200
      }
    ]
  }
}

get

Get Vault TVL history by slug for the given date range

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

Responses

200

Vault TVL history

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/tvl-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/tvl-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "tvl": 1
      }
    ]
  }
}

get

Get Vault holders history by slug

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

Responses

200

Vault holders history

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/holders-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/holders-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "chainId": 1,
        "start": 1,
        "end": 1,
        "min": 1,
        "max": 1,
        "average": 1,
        "count": 1
      }
    ]
  }
}

get

Get Vault volume history by slug for the given date range

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

Responses

200

Vault volume history

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/volume-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/volume-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "volume24h": 1
      }
    ]
  }
}

get

Get Vault daily price history by slug

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

chainIdnumber · nullableOptional

Optional chain ID. Defaults to plume mainnet (98866)

Default: 98866

Responses

200

Vault price history

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/price-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/price-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "price": 1
      }
    ]
  }
}

get

Get Vault Liquid Funds history by slug with pagination

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Start date in Unix timestamp seconds

endDatenumber · nullableOptional

End date in Unix timestamp seconds

limitnumber · min: 1 · max: 200Optional

Maximum number of history entries to return

Default: 50Example: 50

cursorstringOptional

Cursor returned from a previous request

Responses

200

Vault Liquid Funds history

application/json

400

Invalid request

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/liquid-funds-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/liquid-funds-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "liquidFunds": 1
      }
    ],
    "pageInfo": {
      "endCursor": "text",
      "hasNextPage": true
    }
  }
}

get

Get Vault pending redemptions history by slug with separate filters for requestedAt and expiresAt

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

requestedAtStartnumber · nullableOptional

Start date for requestedAt filter (Unix timestamp in seconds)

requestedAtEndnumber · nullableOptional

End date for requestedAt filter (Unix timestamp in seconds)

expiresAtStartnumber · nullableOptional

Start date for expiresAt filter (Unix timestamp in seconds)

expiresAtEndnumber · nullableOptional

End date for expiresAt filter (Unix timestamp in seconds)

queueAddressstringOptional

Optional atomic queue address filter.

Responses

200

Vault pending redemptions history

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/pending-redemptions-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/pending-redemptions-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "pendingRedemptions": [
      {
        "requestTransactionHash": "text",
        "user": "text",
        "chainId": 1,
        "amount": 1,
        "requestedAt": 1,
        "expiresAt": 1,
        "wantTokenContractAddress": "text",
        "minPrice": 1,
        "isValid": true
      }
    ]
  }
}

get

Get historical vault composition by slug for the given date range. Returns daily snapshots of asset allocation across all chains, including both liquid and yield assets with their weights and values.

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDatenumber · nullableOptional

Unix timestamp in seconds

endDatenumber · nullableOptional

Unix timestamp in seconds

Default: 1772212720

orderstring · enumOptional

Ordering for history arrays. desc returns newest first. asc returns oldest first.

Default: descExample: descPossible values:

Responses

200

Vault composition history

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/composition-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/composition-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "vaultAddress": "text",
    "history": [
      {
        "day": 1,
        "totalValue": 1,
        "liquidAssets": {
          "totalValue": 1,
          "weight": 1,
          "assets": [
            {
              "assetAddress": "text",
              "chainId": 1,
              "value": 1
            }
          ]
        },
        "yieldAssets": [
          {
            "slug": "text",
            "totalValue": 1,
            "weight": 1,
            "tokens": [
              {
                "tokenAddress": "text",
                "chainId": 1,
                "isPending": true,
                "balance": 1,
                "price": 1,
                "value": 1
              }
            ]
          }
        ]
      }
    ]
  }
}

get

Get vault transaction history by slug

Path parameters

slugstring · min: 1Required

Unique slug identifier for the vault.

Example: nest-alpha-vault

Query parameters

startDateinteger · nullableOptional

Start date filter (epoch seconds)

endDateinteger · nullableOptional

End date filter (epoch seconds)

chainIdnumber · nullableOptional

Optional chain ID. If omitted, returns transactions across all chains.

transactionTypesstringOptional

Optional comma-separated transaction types. Example: DEPOSIT,WITHDRAW_FULFILL

Example: DEPOSIT,WITHDRAW_FULFILL

limitnumber · min: 1 · max: 200Optional

Maximum number of transactions to return

Default: 50Example: 50

cursorstringOptional

Cursor returned from a previous request

Responses

200

Vault transaction history

application/json

400

Invalid request

application/json

404

Not found

application/json

500

Server error

application/json

get

/vaults/{slug}/transaction-history

HTTPcURLJavaScriptPython

GET /v1/vaults/{slug}/transaction-history HTTP/1.1
Host: api.nest.credit
Accept: */*

{
  "data": {
    "items": [
      {
        "transactionHash": "0x1234567890123456789012345678901234567890",
        "transactionType": "DEPOSIT",
        "vaultAddress": "0x1234567890123456789012345678901234567890",
        "user": "0x1234567890123456789012345678901234567890",
        "createdAt": 1717334400,
        "shares": 100,
        "sharesTokenAddress": "0x1234567890123456789012345678901234567890",
        "assets": 100,
        "assetsTokenAddress": "0x1234567890123456789012345678901234567890",
        "chainId": 1
      }
    ],
    "pageInfo": {
      "endCursor": "text",
      "hasNextPage": true
    }
  }
}