---
title: "Wallet balance (balance / held / available)"
method: GET
path: "/wallet"
tags: ["Wallet"]
---

# Wallet balance (balance / held / available)

`GET /wallet`

## Request

- Base URL: `https://esahayak.io/api/v1`
- URL: `https://esahayak.io/api/v1/wallet`
- Auth: HTTP bearer

## Response `200`

Current wallet balance.

- Wallet: Top-level fields are the STAMP_DUTY (face value) wallet; `serviceFee` is the prepaid service-fee wallet (zeros when not enabled). With a `sk_test_` key this is a SIMULATED sandbox wallet (`simulated: true`) with an unlimited balance — sandbox orders never consume it.
  - `mode` 'test' | 'live': Which key mode produced this response.
  - `simulated` boolean: true for sandbox (`sk_test_`) keys: the balance is a fake unlimited figure, not real money. Never gate a live flow on a simulated balance.
  - `balance` number: Total funded.
  - `held` number: Reserved for in-flight orders.
  - `available` number: balance − held; what new orders can draw.
  - `lowBalanceThreshold` number, nullable
  - `currency` string
  - `serviceFee` object: Prepaid service-fee wallet (gross, GST settled at top-up).
    - `balance` number
    - `held` number
    - `available` number
    - `lowBalanceThreshold` number, nullable

---

[API](https://skmtc.dev/esahayak/apis/esahayak-stamp-api.md) - [All operations](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/esahayak/apis/esahayak-stamp-api/revisions/cca124862a3e?raw)