GET /api/balance

{
  "usdcBalance": "50.000000",
  "creditBalance": "5.000000",
  "totalBalance": "55.000000",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "hasWallet": true,
  "network": "base-sepolia",
  "chainType": "ethereum"
}

curl https://api.agnic.ai/api/balance \
  -H "X-Agnic-Token: agnic_tok_YOUR_TOKEN"

curl "https://api.agnic.ai/api/balance?network=base" \
  -H "X-Agnic-Token: agnic_tok_YOUR_TOKEN"

import requests

response = requests.get(
    "https://api.agnic.ai/api/balance",
    headers={"X-Agnic-Token": "agnic_tok_YOUR_TOKEN"},
    params={"network": "base-sepolia"}
)

data = response.json()
print(f"Total Balance: ${data['totalBalance']}")
print(f"USDC: ${data['usdcBalance']} | Credit: ${data['creditBalance']}")
print(f"Address: {data['address']}")

const response = await fetch(
  'https://api.agnic.ai/api/balance?network=base-sepolia',
  {
    headers: {
      'X-Agnic-Token': 'agnic_tok_YOUR_TOKEN'
    }
  }
);

const { totalBalance, usdcBalance, creditBalance, address } = await response.json();
console.log(`Total Balance: $${totalBalance}`);
console.log(`USDC: $${usdcBalance} | Credit: $${creditBalance}`);
console.log(`Address: ${address}`);

import requests

def check_can_afford(amount_usd):
    response = requests.get(
        "https://api.agnic.ai/api/balance",
        headers={"X-Agnic-Token": "agnic_tok_YOUR_TOKEN"}
    )

    balance = float(response.json()["totalBalance"])
    return balance >= amount_usd

# Check if we can afford a $0.50 transaction
if check_can_afford(0.50):
    print("Sufficient balance")
else:
    print("Insufficient balance - please add funds")

{
  "error": "invalid_network",
  "error_description": "Network 'invalid' is not supported"
}

{
  "usdcBalance": "0",
  "creditBalance": "5.000000",
  "totalBalance": "5.000000",
  "address": null,
  "hasWallet": false,
  "network": "base-sepolia",
  "chainType": "ethereum"
}