API reference Vaultody

GET /vaults/{vaultId}/vault-accounts/{vaultAccountId}/list-addresses

List Addresses by Vault Account ID

Retrieves a list of all addresses associated with a specific vault account within a vault, along with their current balances.

Path parameters

vaultAccountId string required

Unique identifier of the vault account.

vaultId string required

Unique identifier of the vault.

Query parameters

context string

In batch situations the user can use the context to correlate responses with requests. This property is present regardless of whether the response was successful or returned as an error. `context` is specified by the user.

assetId string

Unique identifier of the asset.

blockchain string

Filters addresses by blockchain, e.g bitcoin, tron, litecoin, solana, binance-smart-chain.

limit integer

Defines how many items should be returned in the response per page basis.

startingAfter string

Defines the id of the previous listed record id from which the current list should start from.

Response

Returns 200 the request has been successful.

apiVersion string required

Specifies the version of the API that incorporates this endpoint.

E.G. 2026-03-20

requestId string required

Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.

E.G. 601c1710034ed6d407996b30

context string

E.G. yourExampleString

data object required

limit integer required

Defines how many items should be returned in the response per page basis.

E.G. 50

startingAfter string

Defines the id of the previous listed record id from which the current list should start from.

E.G. 5ca21f92cf5431000105d1a7

hasMore boolean required

Defines whether or not there are more elements available after this set.

E.G. 1

items object[] required

address string required

Blockchain address.

E.G. 0xa5bd60af2ed1499ce8292bb2e6c0179dcea34f33

addressId string required

Unique identifier of the address (address ID to start after).

E.G. 68e4c62889a82e0ff4d8f737

addressIndex string required

Derivation index of the address within the vault account.

E.G. 1

balances object[] required

amount string required

Balance amount for the asset on this address.

E.G. 0.123

assetId string required

Unique identifier of the asset.

E.G. 68e4c62889a82e0ff4d8f737

assetUnit string required

Asset symbol (e.g., BTC, ETH, USDT, TRX).

E.G. ETH

blockchain string required

Blockchain for the address (e.g., bitcoin, ethereum, tron).

E.G. ethereum

createdTimestamp integer required

Unix timestamp (seconds) indicating when the address was created.

E.G. 1759823400

label string required

Human-readable label assigned to the address.

E.G. Name address

Errors

400 The pagination attributes that have been used are invalid. Please check the Documentation to see details on pagination. application/json

401 The provided API key is invalid. Please, generate a new one from your Dashboard. application/json

403 Mainnets access is not available for your current subscription plan, please upgrade your plan to be able to use it. application/json

404 The specified resource has not been found. application/json

409 The data provided seems to be invalid. application/json

415 The selected Media Type is unavailable. The Content-Type header should be 'application/json'. application/json

422 Your request body for POST requests must have a structure of { data: { item: [...properties] } } application/json

429 The request limit has been reached. There can be maximum {requests} requests per {seconds} second(s) made. Please contact our team via email if you need more or upgrade your plan. application/json

500 An unexpected server error has occurred, we are working to fix this. Please try again later and in case it occurs again please report it to our team via email. application/json