Skip to main content
GET
/
billing
/
balance
/api/v1/billing/balance
curl --request GET \
  --url https://api.venice.ai/api/v1/billing/balance \
  --header 'Authorization: Bearer <token>'
{
  "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

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
​
diemEpochAllocation
number
required

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

Example:

100