Managing your balances
Check your balance using the API and set up alerts to notify you when your balance is low
Your balance is the amount of money available in your account to pay for orders. If you don’t have enough balance, attempts to order will be rejected with a insufficient_funds
error.
We offer a number of ways to check your balance and set up alerts to notify you when your balance is low.
- An API endpoint to fetch your current balance, either for all currencies or for a single currency
- Predictive balance emails when your balance is expected to become low based on your previous order volumes
- Custom balance thresholds that notify you when your balance falls below a specific threshold
You may hold balances in multiple currencies. See the list of supported currencies for an understanding of available options.
Checking balances in the API
The balance endpoint can be used to fetch balances for all currencies or for a single currency.
Checking all available balances
To retrieve information on all balances associated with your account, initiate a GET request to the /v2/balance
endpoint.
Each object in the array represents the total available balance for a specific currency:
balance
denotes the current available funding for the specified currencycurrency
is represented by the ISO4217 three-letter currency code
Checking the balance for a single currency
To obtain the balance for a specific currency, include the three-letter currency code in the GET request: /v2/balance/?currency=[CURRENCY]
For example, a request to /v2/balance/?currency=GBP
will yield a single object in response. This API responds to other currencies with a value of 0, as long as the currency is supported on our platform.
balance
denotes the current available funding for the specified currencycurrency
is represented by the ISO4217 three-letter currency code
Setting up alerts
Two types of alerts are available. Predictive balance emails automatically notify you when your balance is expected to become low based on your previous order volumes. Custom balance thresholds allow you to set a specific balance threshold and be notified when your balance falls below that threshold.
Both types of alerts can be configured in the Runa dashboard under the settings page.