Fetch Approved Blockchain Assets

This endpoint retrieves the list of all blockchain assets that have been approved and are available on the platform. These assets can be added to an institution or sub-entity vault.

GET {{host}}/api/v1/assets/fetch

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`	Array of approved asset objects
4.1	`data[].id`	Unique identifier of the asset (used when adding an asset to a vault)
4.2	`data[].displayName`	Human-readable name of the asset
4.3	`data[].displaySymbols`	Display ticker symbol of the asset (e.g. cNGN, USDC)
4.4	`data[].onChainDecimals`	Number of decimal places used on-chain
4.5	`data[].blockchainId`	Identifier of the blockchain network the asset runs on
4.6	`data[].blockchainDisplayName`	Human-readable name of the blockchain network

Sample Response (Success)

{
  "success": true,
  "responseCode": "200",
  "responseMessage": "Success",
  "data": [
    {
      "id": "CNGN_B75VRLGX_8GWM",
      "displayName": "Cardano Nigerian Naira",
      "displaySymbols": "cNGN",
      "onChainDecimals": 6,
      "blockchainId": "BASE_TEST",
      "blockchainDisplayName": "Base Testnet"
    },
    {
      "id": "USDC_K92PXMTY_4JNR",
      "displayName": "USD Coin",
      "displaySymbols": "USDC",
      "onChainDecimals": 6,
      "blockchainId": "BASE_TEST",
      "blockchainDisplayName": "Base Testnet"
    }
  ]
}

Sample Response (Failure)

{
  "success": false,
  "responseCode": "401",
  "responseMessage": "Unauthorized"
}