Get Balance

Retrieve the total, transferable, and frozen balance for an account

GET /stocks/api/fetch/balance/{tokenAddress}/{account}

cURL

curl "https://api.trusset.org/stocks/api/fetch/balance/0x1234.../0xAbC123..." \
  -H "X-API-Key: trusset_abc123xy_secret..."

Response

{
  "success": true,
  "data": {
    "account": "0xAbC123dEf456789012345678901234567890AbCd",
    "total": "5000",
    "transferable": "4200",
    "frozen": "800"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z",
    "instanceId": "inst_abc123"
  }
}

Returns the token balance breakdown for a specific account. The response separates the total balance into its transferable and frozen components.

Path Parameters

tokenAddress · string · required

Address of the stock token contract.

account · string · required

Ethereum address of the account to query.

Response Fields

success · boolean

Request status.

data · object

Show child attributes

account · string

Queried account address.

total · string

Total balance (transferable + frozen).

transferable · string

Balance available for transfers.

frozen · string

Balance locked by freeze operations.

cURL

curl "https://api.trusset.org/stocks/api/fetch/balance/0x1234.../0xAbC123..." \
  -H "X-API-Key: trusset_abc123xy_secret..."

Response

{
  "success": true,
  "data": {
    "account": "0xAbC123dEf456789012345678901234567890AbCd",
    "total": "5000",
    "transferable": "4200",
    "frozen": "800"
  },
  "metadata": {
    "requestId": "550e8400-e29b-41d4-a716-446655440000",
    "timestamp": "2025-06-15T12:00:00.000Z",
    "instanceId": "inst_abc123"
  }
}