Estimate Sub-Entity Transfer Fee

This endpoint calculates the estimated network fee for a proposed sub-entity transfer before it is submitted.

POST {{host}}/api/v1/transactions/transfer/sub-entity/estimate

Content-Type: application/json

Sample Request

{
  "sourceEntityId": "78",
  "assetId": "CNGN_B75VRLGX_8GWM",
  "amount": "200.00",
  "clientRef": "TXN-20260521-00456",
  "note": "Fee estimate for sub-entity payout",
  "type": "VAULT_ACCOUNT_TO_ONE_TIME_ADDRESS",
  "address": "0xDEF05678.............."
}

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": "0.80",
    "networkFee": "0.0009",
    "transactionId": "ISW-EST-20260521-5K2M",
    "availableBalance": "1200.00"
  }
}

Sample Response (Failure)

{
  "success": false,
  "responseCode": "404",
  "responseMessage": "Entity Not Found"
}