---
title: "Get Solana Wallet Balance"
method: GET
path: "/v1/solana/wallets/{address}/balance"
tags: ["Solana"]
---

# Get Solana Wallet Balance

`GET /v1/solana/wallets/{address}/balance`

Get the SOL or SPL token balance for a Solana wallet on a specific Solana network.

**Authentication**: Pass `x-client-id` for frontend usage from allowlisted origins or `x-secret-key` for backend usage.

## Path parameters

- `address` string, required — Public key of the Solana wallet.

## Query parameters

- `chainId` string, required — Solana network to query. Choose either solana:mainnet or solana:devnet.
- `tokenAddress` string — SPL token mint address. Omit to retrieve native SOL balance.

## Response `200`

Wallet balance retrieved successfully for the requested Solana network.

- object
  - `result` object, required — Balance data for the requested Solana network.
    - `chainId` string, required — Requested Solana network.
    - `decimals` integer, required — Number of decimals used by the token.
    - `displayValue` string, required — Human-readable balance formatted using token decimals.
    - `value` string, required — Raw balance value expressed in base units (lamports).

## Other responses

- `400` — Invalid request parameters. This occurs when the wallet address or token mint is invalid, or the request mixes a token mint with multiple networks.
- `401` — Authentication required. Include `x-client-id` or `x-secret-key` headers.
- `500` — Internal server error. This may occur due to RPC connectivity issues or unexpected failures.

---

[API](https://skmtc.net/thirdweb/apis/thirdweb-api.md) · [All operations](https://skmtc.net/thirdweb/apis/thirdweb-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thirdweb/thirdweb-api/revisions/fb4cb67da1c7/schema)