Skip to main content
The balance endpoint returns your current account balance in both micro-USD (integer) and USD (string). Balances are credited when you deposit via the Darkbloom console and debited after each inference request completes. balance_micro_usd is the canonical value — all internal billing uses micro-USD to avoid floating-point rounding errors. The balance_usd string is a human-readable convenience field formatted to six decimal places. withdrawable_micro_usd reflects funds that can be withdrawn (for provider earnings). This will be zero for consumer-only accounts.

​
Authentication

This endpoint requires a Bearer token: 
Authorization: Bearer eigeninference-...

​
Response

​
balance_micro_usd
integer
Your current balance in micro-USD (1 USD = 1,000,000 micro-USD). Use this value for precise balance comparisons and cost calculations.
​
balance_usd
string
Your current balance as a USD string formatted to six decimal places, e.g. "1.250000".
​
withdrawable_micro_usd
integer
The portion of your balance available for withdrawal, in micro-USD. For consumer accounts this is typically 0.
​
withdrawable_usd
string
Withdrawable balance as a USD string formatted to six decimal places.

​
Example

cURL
curl https://api.darkbloom.dev/v1/payments/balance \
  -H "Authorization: Bearer eigeninference-..."

​
Example response

{
  "balance_micro_usd": 4750000,
  "balance_usd": "4.750000",
  "withdrawable_micro_usd": 0,
  "withdrawable_usd": "0.000000"
}