---
updatedAt: 2025-11-11T23:14:21.000Z
agentTools:
projectIndex: https://developers.fortresstrust.com/llms.txt
---
# Retrieve the custodial account balances. (Auth)
# OpenAPI definition
```json
{
"openapi": "3.0.1",
"info": {
"title": "Core Api",
"version": "1.0"
},
"servers": [
{
"url": "https://api.sandbox.fortressapi.com/"
}
],
"paths": {
"/api/trust/v1/custodial-accounts/{custodialAccountId}/balances": {
"get": {
"tags": [
"CustodialAccounts"
],
"summary": "Retrieve the custodial account balances. (Auth)",
"parameters": [
{
"name": "custodialAccountId",
"in": "path",
"description": "Custodial account identifier",
"required": true,
"schema": {
"type": "string",
"format": "uuid"
}
}
],
"responses": {
"200": {
"description": "Successfully retrieved the custodial account balances",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/CustodialAccountBalancesResponseModelCollectionResponseModel"
}
}
}
},
"401": {
"description": "Unauthorized"
},
"403": {
"description": "Forbidden"
},
"404": {
"description": "Custodial account was not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ProblemDetails"
},
"examples": {
"Example 1": {
"summary": "Validation exception",
"value": {
"title": "string",
"status": 404,
"traceId": "string",
"path": "string",
"errors": {
"00000000-0000-0000-0000-000000000000": [
"Validation error"
]
}
}
},
"Example 2": {
"summary": "Not found",
"value": {
"type": "string",
"title": "Not Found",
"status": 404,
"traceId": "string"
}
}
}
}
}
}
},
"security": [
{
"Bearer": []
}
]
}
}
},
"components": {
"schemas": {
"CustodialAccountBalancesResponseModel": {
"type": "object",
"properties": {
"assetType": {
"$ref": "#/components/schemas/ModelAssetType"
},
"assetTypeId": {
"type": "string",
"description": "AssetType id",
"nullable": true
},
"assetFiatType": {
"$ref": "#/components/schemas/ModelAssetFiatType"
},
"network": {
"$ref": "#/components/schemas/ModelNetworkChain"
},
"disbursable": {
"type": "number",
"description": "Disbursable balance",
"format": "double"
},
"locked": {
"type": "number",
"description": "Locked balance",
"format": "double"
},
"pending": {
"type": "number",
"description": "Pending balance",
"format": "double"
},
"total": {
"type": "number",
"description": "Total balance",
"format": "double"
},
"subBalances": {
"$ref": "#/components/schemas/SubBalancesResponseModel"
},
"subAccounts": {
"type": "array",
"items": {
"$ref": "#/components/schemas/SubAccountBalanceResponseModel"
},
"description": "Sub balances",
"nullable": true
}
},
"additionalProperties": false,
"description": "Custodial account balances response model"
},
"CustodialAccountBalancesResponseModelCollectionResponseModel": {
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"$ref": "#/components/schemas/CustodialAccountBalancesResponseModel"
},
"description": "Gets or sets the data.",
"nullable": true
}
},
"additionalProperties": false,
"description": "Collection response model"
},
"ModelAssetFiatType": {
"enum": [
"usd",
"btc",
"eth",
"matic",
"usdc",
"sol",
"ada",
"xlm",
"dot",
"link",
"algo",
"bnb",
"busd",
"avax",
"ltc",
"uni",
"crv",
"aave",
"eos",
"bch",
"xtz",
"comp",
"bat",
"shib",
"doge",
"grt",
"sushi",
"sand",
"enj",
"axs",
"mana",
"mkr",
"yfi",
"atom",
"ape",
"dai",
"usdt",
"near",
"trx",
"ftm",
"xrp",
"flrns",
"flow",
"smtf",
"qnt",
"chz",
"gala",
"hbar",
"pol",
"gold",
"silver"
],
"type": "string",
"description": "Asset fiat type"
},
"ModelAssetType": {
"enum": [
"fiatCurrency",
"cryptoCurrency",
"privateSecurity",
"nft",
"preciousMetal"
],
"type": "string"
},
"ModelNetworkChain": {
"enum": [
"mainnet",
"ropsten",
"goerli",
"bnbSmartChainMainnet",
"eosMainnet",
"bnbSmartChainTestnet",
"polygonMainnet",
"fantomMainnet",
"eosTestnet",
"bitcoinMainnet",
"cosmosHub",
"cosmosHubTestnet",
"bitcoinTestnet",
"bchMainnet",
"bchTestnet",
"solanaMainnet",
"solanaDevnet",
"solanaTestnet",
"polkadotMainnet",
"polkadotWestend",
"cardanoMainnet",
"cardanoTestnet",
"algorandMainnet",
"algorandTestnet",
"stellarMainnet",
"stellarTestnet",
"litecoinMainnet",
"litecoinTestnet",
"tezosMainnet",
"tezosTestnet",
"arbitrumMainnet",
"avalancheFuji",
"avalancheMainnet",
"polygonMumbai",
"polygonAmoy",
"rippleMainnet",
"rippleTestnet",
"arbitrumGoerli",
"arbitrumSepolia",
"dogeTestnet",
"dogeMainnet",
"nearMainnet",
"nearTestnet",
"tronMainnet",
"tronTestnet",
"flowMainnet",
"flowTestnet",
"hederaMainnet",
"hederaTestnet",
"sepolia"
],
"type": "string",
"description": "Supported networks"
},
"ProblemDetails": {
"type": "object",
"properties": {
"type": {
"type": "string",
"nullable": true
},
"title": {
"type": "string",
"nullable": true
},
"status": {
"type": "integer",
"format": "int32",
"nullable": true
},
"detail": {
"type": "string",
"nullable": true
},
"instance": {
"type": "string",
"nullable": true
}
},
"additionalProperties": {}
},
"SubAccountBalanceResponseModel": {
"type": "object",
"properties": {
"subAccountId": {
"type": "string",
"description": "Disbursable balance",
"format": "uuid"
},
"disbursable": {
"type": "number",
"description": "Disbursable balance",
"format": "double"
},
"locked": {
"type": "number",
"description": "Locked balance",
"format": "double"
},
"pending": {
"type": "number",
"description": "Pending balance",
"format": "double"
},
"total": {
"type": "number",
"description": "Total balance",
"format": "double"
}
},
"additionalProperties": false
},
"SubBalancesResponseModel": {
"type": "object",
"properties": {
"pendingFromTrade": {
"type": "number",
"format": "double"
},
"lockedPendingFromTrade": {
"type": "number",
"format": "double"
}
},
"additionalProperties": false
}
},
"securitySchemes": {
"Bearer": {
"type": "apiKey",
"description": "Put access token in the box below.
For example: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsImtpZCI6I",
"name": "Authorization",
"in": "header"
}
}
},
"security": [
{
"Bearer": []
}
],
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
}
}
```