Skip to content
Alchemy Logo

Vault details

This API is in private preview. Target October 2026; timing is subject to change.

Returns a vault's configuration, performance history, and follower state.

Coming with HyperCore. This read is documented but is not yet callable.

POST /{apiKey}/info

ParameterTypeRequiredDescription
typestringYesSelects vaultDetails.
vaultAddressstringYesVault address.
userstringYesMaster or sub-account address.
{
  "type": "vaultDetails",
  "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "user": "0x0000000000000000000000000000000000000000"
}

FieldTypeDescription
namestringDisplay name assigned to the vault.
vaultAddressstringOnchain address that identifies the vault.
leaderstringAddress authorized to manage the vault's positions.
descriptionstringVault-provided summary for prospective followers.
portfolioarrayPerformance history by interval.
portfolio[][0]stringTime interval label for the paired performance data.
portfolio[][1].accountValueHistoryarrayTimestamped account-value observations for that interval.
portfolio[][1].pnlHistoryarrayTimestamped profit-and-loss observations for that interval.
portfolio[][1].vlmstringTrading volume recorded for that interval as a decimal string.
aprnumberAnnualized return.
followerStateobject | nullFollower state for the requesting user, or null when none exists.
leaderFractionnumberFraction of vault equity owned by the vault leader.
leaderCommissionnumberFraction of follower profit charged as leader commission.
followers[]arrayAccounts with an equity position in the vault.
followers[].userstringAddress of the account following the vault.
followers[].vaultEquitystringFollower's vault equity as a decimal string.
followers[].pnlstringFollower profit and loss for the current reporting period.
followers[].allTimePnlstringFollower cumulative profit and loss since joining.
followers[].daysFollowingintegerWhole days since the account began following the vault.
followers[].vaultEntryTimeintegerTime in milliseconds when the follower entered the vault.
followers[].lockupUntilintegerTime in milliseconds before which the follower cannot withdraw.
maxDistributablenumberMaximum amount currently available for distribution.
maxWithdrawablenumberMaximum amount currently available for withdrawal.
isClosedbooleanWhether the vault is closed.
relationshipobjectVault relationship metadata, such as its parent or child links.
allowDepositsbooleanWhether deposits are allowed.
alwaysCloseOnWithdrawbooleanWhether withdrawals close positions.

{
  "name": "Test",
  "vaultAddress": "0xdfc24b077bc1425ad1dea75bcb6f8158e10df303",
  "leader": "0x677d831aef5328190852e24f13c46cac05f984e7",
  "description": "Community-owned vault",
  "portfolio": [
    [
      "day",
      {
        "accountValueHistory": [[1734397526634, "329265410.90790099"]],
        "pnlHistory": [[1734397526634, "0.0"]],
        "vlm": "0.0"
      }
    ]
  ],
  "apr": 0.36387129259090006,
  "followerState": null,
  "leaderFraction": 0.0007904828725729887,
  "leaderCommission": 0,
  "followers": [],
  "maxDistributable": 94856870.164485,
  "maxWithdrawable": 742557.680863,
  "isClosed": false,
  "relationship": { "type": "parent", "data": { "childAddresses": [] } },
  "allowDeposits": true,
  "alwaysCloseOnWithdraw": false
}
Was this page helpful?