Add Asset to Institution Vault

This endpoint adds a blockchain asset to the institution associated with the auth token. Once added, the institution gets a dedicated blockchain wallet address for that asset, enabling it to send, receive, and manage balances for that specific asset.

POST {{host}}/api/v1/institutions/asset/add

Content-Type: application/json

Request Message Description

#	Field Name	Data Type	Max Length (API)	Max Length (UI)	Required	Description
1	`assetId`	String	-	-	Yes	Unique identifier of the blockchain asset to be added to the institution (e.g. `CNGN_B75VRLGX_8GWM`)

Sample Request

{
  "assetId": "CNGN_B75VRLGX_8GWM"
}

Response Message Field Description

#	Field Name	Description
1	`success`	Indicates whether the request was successful (`true` for success)
2	`responseCode`	HTTP-like response code (e.g. `200` for success)
3	`responseMessage`	Human-readable result message (e.g. `Success`)
4	`data`	Object containing details of the asset added to the institution
4.1	`data.institutionId`	Unique internal ID of the institution the asset was added to
4.2	`data.vaultId`	Vault identifier associated with the institution
4.3	`data.assetId`	Unique identifier of the blockchain asset that was added
4.4	`data.address`	Blockchain wallet address generated for this institution and asset
4.5	`data.availableBalance`	Current available balance of the asset in the institution's wallet
4.6	`data.frozenBalance`	Amount of the asset currently frozen and unavailable for transactions

Sample Response (Success)

{
  "success": true,
  "responseCode": "200",
  "responseMessage": "Success",
  "data": {
    "institutionId": 2,
    "vaultId": "3",
    "assetId": "CNGN_B75VRLGX_8GWM",
    "address": "0x2dE62BA......",
    "availableBalance": "0",
    "frozenBalance": "0"
  }
}

Sample Response (Failure)

{
  "success": false,
  "responseCode": "400",
  "responseMessage": "Invalid Asset Id"
}