GET /api/balance

{
  "usdcBalance": "50.000000",
  "address": "0x1234567890abcdef1234567890abcdef12345678",
  "hasWallet": true,
  "network": "base-sepolia"
}

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"Balance: ${data['usdcBalance']} USDC")
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 { usdcBalance, address } = await response.json();
console.log(`Balance: $${usdcBalance} USDC`);
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()["usdcBalance"])
    return balance >= amount_usd
 
# Check if we can afford a $0.50 payment
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.000000",
  "address": null,
  "hasWallet": false,
  "network": "base-sepolia"
}