---
title: "Retrieve wso2 token balance by wallet address"
method: GET
path: "/api/v1/blockchain/get-balance/{walletAddress}"
tags: ["Transactional"]
---

# Retrieve wso2 token balance by wallet address

`GET /api/v1/blockchain/get-balance/{walletAddress}`

## Path parameters

- `walletAddress` string, required

## Response `200`

Successfully retrieved balance.

- WalletBalanceByAddressResponseDto
  - `message` string, required — A message indicating the result of the API request.
  - `httpCode` number, required — HTTP status code of the response.
  - `payload` WalletBalanceByAddressDto, required
    - `walletAddress` string, required — The wallet address.
    - `balance` string, required — WSO2 Token balance.
    - `tokenBalanceUnFormatted` string, required — Solidity's format representation of the WSO2 token balance.
    - `decimals` number, required — The token's decimal precision.

## Other responses

- `400` — Bad request or wallet address not found.
- `500` — Server Error.

---

[API](https://skmtc.dev/wso2/apis/wso2-transactional-api.md) · [All operations](https://skmtc.dev/wso2/apis/wso2-transactional-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/wso2/wso2-transactional-api/revisions/88a583635618/schema)