Account balance — GET /v1/payments/balance

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

integer

Your current balance in micro-USD (1 USD = 1,000,000 micro-USD). Use this value for precise balance comparisons and cost calculations.

string

Your current balance as a USD string formatted to six decimal places, e.g. "1.250000".

integer

The portion of your balance available for withdrawal, in micro-USD. For consumer accounts this is typically 0.

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"
}

Inference

Account

Network

Account balance — GET /v1/payments/balance

Authentication

Response

Example

Example response

​Authentication

​Response

​Example

​Example response

Authentication

Response

Example

Example response