Balance

GET/v1/balance

Check wallet pockets and limits. There is no request body or query parameters. Returns the key’s environment (test or live).

Multi-currency wallets

Each currency is its own wallet pocket. Do not sum unlike currencies into one headline number.

Top-level balance / availableBalance / pendingBalance / currency / limits are the primary pocket (BDT first when it exists). Also read items: one card per currency.

availableBalance = spendable settled funds for that pocket.
pendingBalance = in-flight pay-ins in that currency (not spendable).

Pocket (`currency`)	Region	Display
`BDT`	Bangladesh	BDT
`BRL`	Brazil	BRL
`USDT`	India H2H	USDT
`USDC`	Europe	USDC
`NGN`	Nigeria	NGN
`PYUSD-USDC`	PYUSD	PYUSD USDC

PYUSD USDC is not Europe USDC. USDC and PYUSD-USDC are separate pockets. EUR payouts debit USDC only and cannot spend PYUSD-USDC.

Do not present GET /v1/account-balance as the merchant’s balance — that is upstream operator crypto, not the Transacty ledger.

Example

cURL

curl -X GET https://api.transacty.ai/v1/balance \
  -H "X-Transacty-Key: $TRANSACTY_KEY" \
  -H "X-Transacty-Timestamp: $TS" \
  -H "X-Transacty-Signature: $SIG" \
  -H "Content-Type: application/json"

Response fields

Field	Type	Description
`environment`	`string`	The key’s mode: `test` or `live`
`balance`	`string`	Primary pocket total
`availableBalance`	`string`	Primary pocket spendable amount
`pendingBalance`	`string`	Primary pocket in-flight pay-ins
`currency`	`string`	Primary pocket code (BDT-first when it exists)
`lastUpdated`	`string \| null`	Last update timestamp
`limits`	`object`	Transaction limits for the primary pocket
`limits.payin`	`object`	Pay-in min/max limits
`limits.payin.min`	`number`	Minimum pay-in amount
`limits.payin.max`	`number`	Maximum pay-in amount
`limits.payout`	`object`	Payout min/max limits
`limits.payout.min`	`number`	Minimum payout amount
`limits.payout.max`	`number`	Maximum payout amount
`items`	`object[]`	One card per currency pocket
`items[].currency`	`string`	Pocket code (`BDT`, `BRL`, `USDT`, `USDC`, `NGN`, `PYUSD-USDC`)
`items[].availableBalance`	`string`	Spendable settled funds for that pocket
`items[].pendingBalance`	`string`	In-flight pay-ins in that currency
`items[].region`	`string`	Market / rail that owns the pocket
`items[].displayLabel`	`string`	Label for UI cards