Balance

GET/v1/balance

Check the primary wallet pocket and limits. There is no request body or query parameters.

Multi-currency wallets

Each currency is its own wallet pocket (e.g. BDT, BRL, USDT, USDC). Do not sum unlike currencies into one headline number.

availableBalance = settled ledger balance, spendable for payout.
pendingBalance = sum of pending pay-ins in that currency (in-flight, not spendable).

GET /v1/balance returns the primary pocket (BDT-first when multiple exist). To render one card per pocket (Bangladesh BDT, Brazil BRL, India USDT, Europe USDC), the dashboard uses the portal endpoint GET /portal/me/wallets.

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
`balance`	`string`	Total wallet balance
`availableBalance`	`string`	Available amount for use
`pendingBalance`	`string`	Amount in pending state
`currency`	`string`	Currency code (example: `BDT`)
`lastUpdated`	`string \| null`	Last update timestamp
`limits`	`object`	Transaction limits object
`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