Get Currency Balance

Retrieve the balance for a specific currency without listing every wallet.

Request

curl --request GET \
  --url "$baseUrl/organizations/balance/{currency}" \
  --header 'x-api-key: YOUR_API_KEY'
Path paramRequiredDescription
currencyYesCurrency code, e.g. USD, NGN, USDC

Response

Returns the balance details for the requested currency.

When to use this vs. List Financial Accounts

Use this when you already know which currency you care about and just need the number — e.g., checking sufficient balance before generating a quote. Use List Financial Accounts when you need to see everything at once, like rendering a dashboard.


Did this page help you?