API reference
Vaultody
PUT
/vaults/{vaultId}/vault-accounts/{vaultAccountId}/add-asset
Add Asset to Address
This endpoint adds a specific asset to an existing vault account and creates an address for it if one does not already exist, enabling the asset to be tracked, receive balances, and be used in future transactions.
Path parameters
vaultAccountId
string
required
Unique identifier of the vault account to which the asset will be added.
vaultId
string
required
Unique identifier of the vault that owns the vault account.
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.
Body parameters application/json
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.
data
object
required
item
object
required
address
string
e.g. 0xa5bd60af2ed1499ce8292bb2e6c0179dcea34f...
Address to associate with the asset. Used when the target address for adding the asset already exists in the vault account. Optional, but required if label is not provided.
assetId
string
required
e.g. 6913471c6b2794841dc8fb84
Unique identifier of the asset to be added.
label
string
e.g. Address name
Optional, but required if address is not provided. Used when there is no existing address for the asset in the vault account.
Response
Returns 200 the request has been successful.
apiVersion
string
required
Specifies the version of the API that incorporates this endpoint.
requestId
string
required
Defines the ID of the request. The `requestId` is generated by Vaultody and it's unique for every request.
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.
data
object
required
item
object
required
address
string
required
Blockchain address associated with the asset.
assetUnit
string
required
Ticker symbol of the added asset (e.g.,ETH, BTC, TRX, USDT).
balance
string
required
Current balance of the asset in the address.
contractAddress
string
required
Smart contract address of the token.
decimals
string
required
Number of decimal places supported by the asset.