Estimate Institution Transfer Fee

This endpoint calculates the estimated network fee for a proposed institution transfer before it is submitted. It is used to preview costs and validate available balance before calling the transfer endpoint.

POST {{host}}/api/v1/transactions/transfer/estimate

Content-Type: application/json

Sample Request

{
  "assetId": "CNGN_B75VRLGX_8GWM",
  "amount": "500.00",
  "clientRef": "TXN-20260521-00123",
  "note": "Fee estimate for settlement batch #42",
  "type": "VAULT_ACCOUNT_TO_ONE_TIME_ADDRESS",
  "address": "0xABCD1234.............."
}

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 the fee estimate details
4.1	`data.assetId`	Unique identifier of the asset for which the fee was estimated
4.2	`data.fee`	Estimated platform or protocol fee for the transaction
4.3	`data.networkFee`	Estimated blockchain network gas fee
4.4	`data.transactionId`	A provisional transaction identifier tied to this estimate
4.5	`data.availableBalance`	Current available balance of the asset in the institution's vault

Sample Response (Success)

{
  "success": true,
  "responseCode": "200",
  "responseMessage": "Success",
  "data": {
    "assetId": "CNGN_B75VRLGX_8GWM",
    "fee": "1.50",
    "networkFee": "0.0012",
    "transactionId": "ISW-EST-20260521-3H7P",
    "availableBalance": "5000.00"
  }
}

Sample Response (Failure)

{
  "success": false,
  "responseCode": "400",
  "responseMessage": "Asset Id, cannot be empty"
}