Skip to main content
GET
/
v1
/
wallet
/
balance
curl -X GET "https://api.danubeai.com/v1/wallet/balance" \
  -H "danube-api-key: YOUR_API_KEY"

{
  "balance_cents": 1500,
  "lifetime_spent_cents": 350,
  "lifetime_deposited_cents": 2000
}

​
Overview

Returns your current wallet balance, including lifetime spending and deposit totals. Use this to check if you have sufficient funds before executing paid tools. Auth: Requires authentication (JWT or API key).

​
Response

​
balance_cents
integer
Current balance in cents (e.g. 1500 = $15.00)
​
lifetime_spent_cents
integer
Total amount spent in cents
​
lifetime_deposited_cents
integer
Total amount deposited in cents

​
Example

curl -X GET "https://api.danubeai.com/v1/wallet/balance" \
  -H "danube-api-key: YOUR_API_KEY"

{
  "balance_cents": 1500,
  "lifetime_spent_cents": 350,
  "lifetime_deposited_cents": 2000
}

​
MCP Tool

This endpoint is also available as the get_wallet_balance MCP tool: 
result = await mcp.call_tool("get_wallet_balance", {})