Billing Balance

Get current balance information for the authenticated user. Returns remaining DIEM/USD balances and total DIEM epoch allocation for calculating usage percentage.

GET /billing/balance

/api/v1/billing/balance

cURL

curl --request GET \
  --url https://api.venice.ai/api/v1/billing/balance \
  --header 'Authorization: Bearer <token>'

200

{
  "canConsume": true,
  "consumptionCurrency": "DIEM",
  "balances": {
    "diem": 90.5,
    "usd": 25
  },
  "diemEpochAllocation": 100
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200

application/json

Successful response

Current balance information for the authenticated user

canConsume · boolean · required

Whether the user has sufficient balance to make API requests

Example:

true

consumptionCurrency · enum<string> | null · required

The currency that will be used for consumption (DIEM or USD)

Available options: USD, VCU, DIEM

Example:

"DIEM"

balances · object · required

Show child attributes

diemEpochAllocation · number · required

Total DIEM allocation for the current epoch (from staking). Use with balances.diem to calculate usage percentage.

Example:

100