Get Wallet Balance

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

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    balance = client.wallet.get_balance()
    print(f"Balance: ${balance.balance_cents / 100:.2f}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const balance = await client.wallet.getBalance();
console.log(`Balance: $${(balance.balanceCents / 100).toFixed(2)}`);

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

GET

wallet

balance

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

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    balance = client.wallet.get_balance()
    print(f"Balance: ${balance.balance_cents / 100:.2f}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const balance = await client.wallet.getBalance();
console.log(`Balance: $${(balance.balanceCents / 100).toFixed(2)}`);

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

from danube import DanubeClient

with DanubeClient(api_key="dk_...") as client:
    balance = client.wallet.get_balance()
    print(f"Balance: ${balance.balance_cents / 100:.2f}")

import { DanubeClient } from 'danube';

const client = new DanubeClient({ apiKey: 'dk_...' });
const balance = await client.wallet.getBalance();
console.log(`Balance: $${(balance.balanceCents / 100).toFixed(2)}`);

{
  "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", {})

Get My Rating Get Spending Limits

​Overview

​Response

​Example

​MCP Tool

Overview

Response

Example

MCP Tool